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INTRODUCTION 


This manual describes the features of UNIX. It provides neither a general overview of UNIX (for that, see “The 
UNIX Time-Sharing System,” BSTJ, Vol. 57, No. 6, Part 2, pp. 1905-29, by D. M. Ritchie and K. Thompson), nor 
details of the implementation of the system (see “UNIX Implementation,” BSTJ, same issue, pp. 1931-46). 

Not all commands, features, and facilities described in this manual are available in every UNIX system; for example, 
yacc{l) is usually not available in a UNIX system running on a PDP-11/23. When in doubt, consult your system’s 
administrator. 

This manual is divided into eight sections, some containing inter-filed sub-classes: 

1. Commands and Application Programs: 

1. General-Purpose Commands. 

1C. Communications Commands. 

IG. Graphics Commands. 

IM. System Maintenance Commands. 

2. System Calls. 

3. Subroutines: 

3C. C and Assembler Library Routines. 

3M. Mathematical Library Routines. 

3S. Standard I/O Library Routines. 

3X. Miscellaneous Routines. 

4. Special Files. 

5. File Formats. 

6. Games. 

7. Miscellaneous Facilities. 

8. System Maintenance Procedures. 

Section 1 {Commands and Application Programs) describes programs intended to be invoked directly by the user or 
by command language procedures, as opposed to subroutines, which are intended to be called by the user’s pro¬ 
grams. Commands generally reside in the directory /bin (for binary programs). Some programs also reside in 
/usr/bin, to save space in /bin. These directories are searched automatically by the command interpreter called the 
shell. Sub-class 1C contains communication programs such as cu, dpr,fget, etc. These entries may differ from sys¬ 
tem to system. Sub-class IM contains system maintenance programs such as fsck, mkfs, etc., which generally reside 
in the directory /etc; these commands are not intended for use by the ordinary user due to their privileged nature. 
Some UNIX systems have a directory called /usr/lbin, containing local commands. 

Section 2 {System Calls) describes the entries into the UNIX supervisor, including the C language interface. 

Section 3 {Subroutines) describes the available subroutines. Their binary versions reside in various system libraries 
in the directories /lib and /usr/Iib. See intro{'i) for descriptions of these libraries and the files in which they are 
stored. 

Section 4 {Special Files) discusses the characteristics of each system file that actually refers to an input/output 
device. The names in this section generally refer to the Digital Equipment Corporation’s device names for the hard¬ 
ware, rather than to the names of the special files themselves. 

Section 5 {File Formats) documents the structure of particular kinds of files; for example, the format of the output 
of the link editor is given in a.out{5). Excluded are files used by only one command (for example, the assembler’s 
intermediate files). In general, the C language struct declarations corresponding to these formats can be found in the 
directories /usr/include and /usr/include/sys. 

Section 6 {Games) describes the games and educational programs that, as a rule, reside in the directory /usr/games. 

Section 7 {Miscellaneous Facilities) contains a variety of things. Included are descriptions of character sets, macro 
packages, etc. 
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Section 8 {System Maintenance Procedures) discusses crash recovery and boot procedures, etc. Information in this section is not 
of great interest to most users. 

Each section consists of a number of independent entries of a page or so each. The name of the entry appears in the upper cor¬ 
ners of its pages. Entries within each section are alphabetized, with the exception of the introductory entry that begins each sec¬ 
tion. The page numbers of each entry start at 1. Some entries may describe several routines, commands, etc. In such cases, the 
entry appears only once, alphabetized under its “major" name. 

All entries are based on a common format, not all of whose parts always appear: 

The NAME part gives the name(s) of the entry and briefly states its purpose. 

The SYNOPSIS part summarizes the use of the program being described. A few conventions are used, particularly in Sec¬ 
tion 1 {Commands)-. 

Boldface strings are literals and are to be typed just as they appear. 

Italic strings usually represent substitutable argument prototypes and program names found elsewhere in the manual 
(they are underlined in the typed version of the entries). 

Square brackets [] around an argument prototype indicate that the argument is optional. When an argument prototype 
is given as “name" or “file", it always refers to 3.file name. 

Ellipses ... are used to show that the previous argument prototype may be repeated. 

A final convention is used by the commands themselves. An argument beginning with a minus -, plus -i-, or equal sign 
= is often taken to be some sort of flag argument, even if it appears in a position where a file name could appear. 
Therefore, it is unwise to have files whose names begin with -, -I-, or =. 

The DESCRIPTION part discusses the subject at hand. 

The EXAMPLE(S) part gives example(s) of usage, where appropriate. 

The FILES part gives the file names that are built into the program. 

The SEE ALSO part gives pointers to related information. 

The DIAGNOSTICS part discusses the diagnostic indications that may be produced. Messages that are intended to be self- 
explanatory are not listed. 

The WARNINGS part points out potential pitfalls. 

The BUGS part gives known bugs and sometimes deficiencies. Occasionally, the suggested fix is also described. 

A table of contents and a permuted index derived from that table precede Section 1. On each index line, the title of the entry to 
which that line refers is followed by the appropriate section number in parentheses. This is important because there is consider¬ 
able duplication of names among the sections, arising principally from commands that exist only to exercise a particular system 
call. 

On most systems, all entries are available on-line via the man{\) command, q.v. 
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HOW TO GET STARTED 


This discussion provides the basic information you need to get started on UNIX: how to log in and log out, how to communicate 
through your terminal, and how to run a program. (See UNIX for Beginners by B. W. Kemighan for a more complete introduc¬ 
tion to the system.) 

Logging in. You must dial up UNIX from an appropriate terminal. UNIX supports full-duplex ASCII terminals. You must also 
have a valid user name, which may be obtained (together with the telephone number(s) of your UNIX system) from the adminis¬ 
trator of your system. Common terminal speeds are 10, 15, 30, and 120 characters per second (110, 150, 300, and 1,200 baud); 
occasionally, speeds of 240, 480, and 960 characters per second (2,400, 4,800, and 9,600 baud) are also available. On some 
UNIX systems, there are separate telephone numbers for each available terminal speed, while on other systems several speeds 
may be served by a single telephone number. In the latter case, there is one ‘ ‘preferred’' speed; if you dial in from a terminal set 
to a different speed, you will be greeted by a string of meaningless characters (the login: message at the wrong speed). Keep hit¬ 
ting the “break” or “attention” key until the login: message appears. Hard-wired terminals usually are set to the correct speed. 

Most terminals have a speed switch that should be set to the appropriate speed and a half-/full-duplex switch that should be set to 
full-duplex. When a connection (at the speed of the terminal) has been established, the system types login: and you then type 
your user name followed by the “return” key. If you have a password (and you should!), the system asks for it, but does not 
print (“echo”) it on the terminal. After you have logged in, the “return”, “new-line”, and “line-feed” keys will give exactly 
the same result. 

It is important that you type your login name in lower case if possible; if you type upper-case letters, UNIX will assume that your 
terminal cannot generate lower-case letters and that you mean all subsequent upper-case input to be treated as lower case. When 
you have logged in successfully, the shell will type a $ to you. (The shell is described below under How to run a program .) 

For more information, consult login{l) and get?y(8), which discuss the login sequence in more detail, and .^/^(l), which tells you 
how to describe the characteristics of your terminal to the system (profile (5) explains how to accomplish this last task automati¬ 
cally every time you log in). 

Logging out. There are two ways to log out: 

1. You can simply hang up the phone. 

2. You can log out by typing an end-of-file indication (ASCII EOT character, usually typed as “control-d”) to the shell. 
The shell will terminate and the login: message will appear again. 

How to communicate through your terminal. When you type to UNIX, a gnome deep in the system is gathering your charac¬ 
ters and saving them. These characters will not be given to a program until you type a “return” (or “new-line”), as described 
above in Logging in. 

UNIX terminal input/output is full-duplex. It has full read-ahead, which means that you can type at any time, even while a pro¬ 
gram is typing at you. Of course, if you type during output, the output will have interspersed in it the input characters. However, 
whatever you type will be saved and interpreted in the correct sequence. There is a limit to the amount of read-ahead, but it is 
generous and not likely to be exceeded unless the system is in trouble. When the read-ahead limit is exceeded, the system throws 
away all the saved characters. 

On an input line from a terminal, the character @ “kills” all the characters typed before it. The character # erases the last char¬ 
acter typed. Successive uses of # will erase characters back to, but not beyond, the beginning of the line; @ and # can be typed 
as themselves by preceding them with \ (thus, to erase a \, you need two #s). These default erase and kill characters can be 
changed; see .sr/y(l). 

The ASCII DC3 (control-s) character can be used to temporarily stop output. It is useful with CRT terminals to prevent output 
from disappearing before it can be read. Output is resumed when a DCl (control-q) or a second DC3 (or any other character, for 
that matter) is typed. The DCl and DC3 characters are not passed to any other program when used in this manner. 

The ASCII DEL (a.k.a. “rubout”) character is not passed to programs, but instead generates an interrupt signal, just like the 
“break”, “interrupt”, or “attention” signal. This signal generally causes whatever program you are running to terminate. It is 
typically used to stop a long printout that you don't want. However, programs can arrange either to ignore this signal altogether, 
or to be notified when it happens (instead of being terminated). The editor ed(l), for example, catches interrupts and stops what 
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it is doing, instead of terminating, so that an interrupt can be used to halt an editor printout without losing the file being edited. 

The quit signal is generated by typing the ASCII FS character. It not only causes a running program to terminate, but also gener¬ 
ates a file with the “core image” of the terminated process. Quit is useful for debugging. 

Besides adapting to the speed of the terminal, UNIX tries to be intelligent as to whether you have a terminal with the “new-line” 
function, or whether it must be simulated with a “carriage-return” and “line-feed” pair. In the latter case, all input “carriage- 
return” characters are changed to “line-feed” characters (the standard line delimiter), and a “carriage-return” and “line-feed” 
pair is echoed to the terminal. If you get into the wrong mode, the j't/yCl) command will rescue you. 

Tab characters are used freely in UNIX source programs. If your terminal does not have the tab function, you can arrange to have 
tab characters changed into spaces during output, and echoed as spaces during input. Again, the j't/yCl) command will set or 
reset this mode. The system assumes that tabs are set every eight character positions. The tahs{\) command will set tab stops on 
your terminal, if that is possible. 

How to run a program. When you have successfully logged into UNIX, a program called the shell is listening to your terminal. 
The shell reads the lines you type, splits them into a command name and its arguments, and executes the command. A command 
is simply an executable program. Normally, the shell looks first in your current directory (see The current directory below) for a 
program with the given name, and if none is there, then in system directories. There is nothing special about system-provided 
commands except that they are kept in directories where the shell can find them. You can also keep commands in your own 
directories and arrange for the shell to find them there. 

The command name is the first word on an input line to the shell; the command and its arguments are separated from one another 
by space and/or tab characters. 

When a program terminates, the shell will ordinarily regain control and type a $ at you to indicate that it is ready for another 
command. The shell has many other capabilities, which are described in detail in sh{l). 

The current directory. UNIX has a file system arranged in a hierarchy of directories. When the system administrator gave you 
a user name, he or she also created a directory for you (ordinarily with the same name as your user name, and known as your 
login or home directory). When you log in, that directory becomes your current or working directory, and any file name you 
type is by default assumed to be in that directory. Because you are the owner of this directory, you have full permissions to read, 
write, alter, or destroy its contents. Permissions to have your will with other directories and files will have been granted or 
denied to you by their respective owners, or by the system administrator. To change the current directory use Ci/(1). 

Path names. To refer to files not in the current directory, you must use a path name. Full path names begin with /, which is the 
name of the root directory of the whole file system. After the slash comes the name of each directory containing the next sub¬ 
directory (followed by a /), until finally the file name is reached (e.g., /usr/ae/filex refers to file filex in directory ae, while ae is 
itself a subdirectory of usr; usr springs directly from the root directory). See intro{2) for a formal definition of path name. 

If your current directory contains subdirectories, the path names of files therein begin with the name of the corresponding subdi¬ 
rectory {without a prefixed /). Without important exception, a path name may be used anywhere a file name is required. 

Important commands that modify the contents of files are cp{\), mv(l), and rm(l), which respectively copy, move (i.e., rename), 
and remove files. To find out the status of files or directories, use ls{l). Use mkdir{l) for making directories and rmdir{l) for 
destroying them. 

For a fuller discussion of the file system, see the references cited at the beginning of the INTRODUCTION above. It may also be 
useful to glance through Section 2 of this manual, which discusses system calls, even if you don’t intend to deal with the system 
at that level. 

Writing a program. To enter the text of a source program into a UNIX file, use ed{\). The four principal languages available 
under UNIX are C (see cc(l)), Fortran (see /77(l)), bs (a compiler/interpreter in the spirit of Basic, see Z).v(l)), and assembly lan¬ 
guage (see <3.9(1)). After the program text has been entered with the editor and written into a file (whose name has the appropri¬ 
ate suffix), you can give the name of that file to the appropriate language processor as an argument. Normally, the output of the 
language processor will be left in a file in the current directory named a.out (if that output is precious, use mv(l) to give it a less 
vulnerable name). If the program is written in assembly language, you will probably need to load with it library subroutines (see 
W(l)). Fortran and C call the loader automatically; programs written in ^>.9(1) are interpreted and, therefore, do not need to be 
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loaded. 

When you have finally gone through this entire process without provoking any diagnostics, the resulting program can be run by 
giving its name to the shell in response to the $ prompt. 

If any execution (run-time) errors occur, you will need adh{l) to examine the remains of your program. On the VAX-11/780, a 
second debugger sdh(l), which allows you to step through C statements rather than assembler instructions, is available. 

Your programs can receive arguments from the command line just as system programs do; see exec{2). 

Text processing. Almost all text is entered through the editor ed(l). The commands most often used to write text on a terminal 
are cat{l), pr{l), and nroff{l). The cat{l) command simply dumps ASCII text on the terminal, with no processing at all. The 
pr{l) command paginates the text, supplies headings, and has a facility for multi-column output. Nroff(l) is an elaborate text 
formatting program, and requires careful forethought in entering both the text and the formatting commands into the input file; it 
produces output on a typewriter-like terminal. Trqffil) is very similar to nroff(l), but produces its output on a phototypesetter (it 
was used to typeset this manual). There are several “macro” packages (especially the so-called mm package) that significantly 
ease the effort required to use nro^{l) and troff(iy, Section 7 entries for these packages indicate where you can find their detailed 
descriptions. 

Surprises. Certain commands provide inter-user communication. Even if you do not plan to use them, it would be well to learn 
something about them, because someone else may aim them at you. To communicate with another user currently logged in, 
write{l) is used; will leave a message whose presence will be announced to another user when he or she next logs in. 

The corresponding entries in this manual also suggest how to respond to these two commands if you are their target. 

When you log in, a message-of-the-day may greet you before the first $. 
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assert.program verification 

atof.convert ASCII to numbers 

bessel.bessel functions 

bsearch.binary search 

conv.character translation 

crypt.DES encryption 

ctermid.generate file name for terminal 

ctime.convert date and time to ASCII 

ctype .character classification 

cuserid.character login name of the user 

ecvt.output conversion 

end.last locations in program 

exp.exponential, logarithm, power, square root functions 

fclose .close or flush a stream 

ferror.stream status inquiries 

floor.absolute value, floor, ceiling, remainder functions 

fopen.open a stream 

fptrap.floating point interpreter 

fread.buffered binary input/output 

frexp.split into mantissa and exponent 
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fseek.reposition a stream 

gamma.log gamma function 

getc .get character or word from stream 

getenv.value for environment name 

getgrent.get group file entry 

getlogin .get login name 

getopt.get option letter from argv 

getpass.read a password 

getpw .get name from UID 

getpwent.get password file entry 

gets.get a string from a stream 

hypot.Euclidean distance 

13tol.convert between 3-byte integers and long integers 

logname.login name of user 

Isearch.linear search and update 

malloc.main memory allocator 

mktemp.make a unique file name 

monitor.prepare execution profile 

nlist.get entries from name list 

perror.system error messages 

plot.graphics interface subroutines 

popen.initiate I/O to/from a process 

printf.output formatters 

putc.put character or word on a stream 

putpwent.write password file entry 

puts.put a string on a stream 

qsort.quicker sort 

rand.random number generator 

regex.regular expression compile/execute 

scanf.formatted input conversion 

setbuf.assign buffering to a stream 

setjmp.non-local goto 

sinh.hyperbolic functions 

sleep.suspend execution for interval 

ssignal .software signals 

stdio.standard buffered input/output package 

string.string operations 

swab.swap bytes 

system.issue a shell command 

tmpfile.create a temporary file 

tmpnam.create a name for a temporary file 

trig.trigonometric functions 

ttyname.find name of a terminal 

ungetc.push character back into input stream 

4. Special Files 

intro.introduction to special files 

cat.phototypesetter interface 

dj.DJ-11 asynchronous multiplexor 

dmc.communications link with built-in DDCMP protocol 

dn.DN-11 ACU interface 

dqs.DQS-11 interface for two-point BSC 
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du.DU-11 synchronous line interface 

dz.DZ-11, DZ-11 /KMC-11, DH-11 asynchronous multiplexers 

err.error-logging interface 

hp.RP04/RP05/RP06 moving-head disk 

hs.RH11/RJS03-RJS04 fixed-head disk file 

ht.TU16 magnetic tape interface 

kl.KL-11 or DL-11 asynchronous interface 

kmc.KMC 11 microprocessor 

Ip.line printer 

mem .core memory 

null.the null file 

pci.parallel communications link interface 

prf.operating system profiler 

rf.RFll/RSll fixed-head disk file 

rk.RK-11/RK03 or RK05 disk 

rl.RL-ll/RLOl disk 

rp.RP-11/RP03 moving-head disk 

St.synchronous terminal interface 

tm.TM11 /TU 10 magnetic tape interface 

trace.event-tracing driver 

tty .general terminal interface 

vp.Versatec printer 

vpm.The Virtual Protocol Machine 

5. File Formats 

intro.introduction to file formats 

a.out.assembler and link editor output 

acct .per-process accounting file format 

ar.archive file format 

checklist.list of file systems processed by fsck 

core.format of core image file 

cpio.format of cpio archive 

dir .format of directories 

dump.incremental dump tape format 

errfile.error-log file format 

fs.format of system volume 

fspec.format specification in text files 

gps.graphical primitive string, format of graphical files 

group.group file 

inittab.control information for init 

inode.format of an inode 

master.master device information table 

mnttab.mounted file system table 

passwd .password file 

plot.graphics interface 

pnch.file format for card images 

profile.setting up an environment at login time 

sccsfile.format of SCCS file 

tp .magnetic tape format 

utmp.utmp and wtmp entry format 
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6. Games 

intro. 

arithmetic. 

back . 

bj. 

chess . 

craps . 

hangman. 

maze. 

moo. 

quiz. 

reversi. 

sky. 

ttt. 

wump. 

7. Miscellaneous Facilities 

intro. 

ascii. 

environ. 

eqnchar. 

fcntl. 

greek . 

man. 

mm. 

mv. 

regexp. 

stat . 

term. 

types . 

8. System Maintenance Procedures 

intro. 

70boot . 

crash. 

diskboot. 

etp. 

filesave. 

getty. 

hasp. 

init. 

makekey. 

mk. 

rc. 

rje. 

romboot. 

rp6fmt. 

sar.. 

tapeboot.. 

unixboot. 

uvac. 


, . . . introduction to games 
. provide drill in number facts 
. . the game of backgammon 
. . . the game of black jack 

.the game of chess 

.the game of craps 

.guess the word 

.generate a maze 

.guessing game 

.... test your knowledge 
. a game of dramatic reversals 
.... obtain ephemerides 

.tic-tac-toe 

the game of hunt-the-wumpus 


.introduction to miscellany 

.map of ASCII character set 

.user environment 

. . special character definitions for eqn and neqn 

.file control options 

. . . graphics for the extended TTY-37 type-box 
. . . macros for formatting entries in this manual 
the MM macro package for formatting documents 
. . . . a macro package for making view graphs 
. . regular expression compile and match routines 

.data returned by stat system call 

.conventional names 

.primitive system data types 


introduction to system maintenance procedures 

.11/70 bootstrap procedures 

.what to do when the system crashes 

.disk bootstrap programs 

.Equipment Test Package 

, . . . daily/weekly UNIX file system backup 

.set the modes of a terminal 

.RJE (Remote Job Entry) to IBM 

.process control initialization 

..generate encryption key 

. . how to remake the system and commands 

.system initialization shell script 

.RJE (Remote Job Entry) to IBM 

.special ROM bootstrap loaders 

.... format and/or check RP06 disk packs 

.system activity report package 

.magnetic tape bootstrap program 

.UNIX startup and boot procedures 

.... RJE (Remote Job Entry) to UNIVAC 
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70boot; 11/70 bootstrap procedures.70boot(8) 

/functions of HP 2640 and 2621-series terminals.hp(l) 

handle special functions of HP 2640 and 2621-series/hp:.hp(l) 

functions of DASI 300 and/ 300, 300s: handle special . 300(1) 

/special functions of DASI 300 and 300s terminals. 300(1) 

of DASI 300 and 300s/ 3(X), 300s: handle special functions . 300(1) 

functions of DASI 300 and 300s terminals./special. 300(1) 

13tol, ltol3: convert between 3-byte integers and long/ .13tol(3C) 

comparison, diffi: 3-way differential file.diff3(l) 

Tektronix 4014 terminal. 4014: paginator for the .4014(1) 

paginator for the Tektronix 4014 terminal. 4014:. 4014(1) 

of the DASI 450 terminal. 450: handle special functions. 450(1) 

special functions of the DASI 450 terminal. 450: handle. 450(1) 

files from the HONEYWELL 6000. fget: retrieve.fget(lC) 

send files to the HONEYWELL 6000. fsend: .fsend(lC) 

output to the HONEYWELL 6000./send phototypesetter .gcat(lC) 

procedures. 70boot: 11/70 bootstrap.70boot(8) 

f77: Fortran 77 compiler.f77(l) 

long and base-64 ASCII. a641,164a: convert between .a641(3C) 

abort: generate an lOT fault.abort(3C) 

abs: integer absolute value.abs(3C) 

abs: integer absolute value.abs(3C) 

floor, fabs, ceil, fmod: absolute value, floor,/.floor(3M) 

of a file, touch: update access and modification times .touch(l) 

utime: set file access and modification times.utime(2) 

accessibility of a file, access: determine .access(2) 

commands, graphics: access graphical and numerical.graphics(lG) 

access: determine accessibility of a file..access(2) 

enable or disable process accounting, acct: .acct(2) 

acctcon: connect-time accounting..acctcon(lM) 

acctprc: process accounting..acctprc(lM) 

acctsh: shell procedures for accounting..acctsh(lM) 

accounting/acct: overview of accounting and miscellaneous .acct(lM) 

accounting and miscellaneous accounting commands./of.acct(lM) 

acct: per-process accounting file format.acct(5) 

search and print process accounting file(s). acctcom: .acctcom(l) 

acctmerg: merge or add total accounting files..acctmerg(lM) 

summary from per-process accounting records./command.acctcms(lM) 

runacct: run daily accounting..runacct(lM) 

process accounting, acct: enable or disable .acct(2) 

and miscellaneous accounting/ acct: overview of accounting.acct(lM) 

file format, acct: per-process accounting.acct(5) 

per-process accounting/ acctcms: command summary from.acctcms(lM) 

process accounting file(s). acctcom: search and print .acctcom(l) 

accounting, acctcon: connect-time.acctcon(lM) 

accounting files, acctmerg: merge or add total.acctmerg(lM) 

acctprc: process accounting.acctprc(lM) 

accounting, acctsh: shell procedures for .acctsh(lM) 

sin, cos, tan, asin, acos, atan, atan2:/ .trig(3M) 

sag: system activity graph.sag(lM) 

sar: system activity report package.sar(8) 

command and generate a system activity report./time a .timex(l) 

current sees file editing activity, sact: print.sact(l) 

dn:DN-ll AeU interface.dn(4) 

adb: debugger.adb(l) 

acctmerg: merge or add total accounting files.acctmerg(lM) 

sees files, admin: create and administer.admin(l) 

admin: create and administer SeeS files.admin(l) 

alarm: set a process’s alarm clock.alarm(2) 

clock, alarm: set a process’s alarm .alarm(2) 

change data segment space allocation, brk, sbrk:.brk(2) 

realloc, calloc: main memory allocator, malloc, free.malloc(3e) 

rp6fmt: format and/or check RP06 disk packs.rp6fmt(8) 

sort: sort and/or merge files.sort(l) 

send, gath: gather files and/or submit RJE jobs.send(lC) 

link editor output, a.out: assembler and .a.out(5) 

introduction to commands and application programs, intro: .intro(l) 
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maintainer. ar: archive and library.ar(l) 

ar: archive file format.ar(5) 

language.be: arbitrary-precision arithmetic.bc(l) 

maintainer. ar: archive and library.ar(l) 

cpio: format of cpio archive.cpio(5) 

ar: archive file format.ar(5) 

VAX-11/780/arev: convert archive files from PDP-11 to.arcv(l) 

tp: manipulate tape archive.tp(l) 

tar: tape file archiver.tar(l) 

cpio: copy file archives in and out.cpio(l) 

fromPDP-11 to VAX-11/780/ arev: convert archive files.arcv(l) 

command, xargs: construct argument list(s) and execute.xargs(l) 

expr: evaluate arguments as an expression.expr(l) 

echo: echo arguments.echo(l) 

getopt: get option letter from argv.getopt(3C) 

be: arbitrary-precision arithmetic language. .bc(l) 

number facts, arithmetic: provide drill in.arithmetic(6) 

expr: evaluate arguments as an expression.expr(l) 

as: assembler for PDP-11.as.pdp(l) 

as: assembler for VAX-11/780.as.vax(l) 

between long and base-64 ASCII. a641,164a: convert.a641(3C) 

ascii: map of ASCII character set.ascii(7) 

convert date and time to ASCII, /asetime, tzset: .ctime(3C) 

set. ascii: map of ASCII character .ascii(7) 

atof, atoi, atol: convert ASCII to numbers.atof(3C) 

and/ ctime, localtime, gmtime, asetime, tzset: convert date.ctime(3C) 

trigonometric/ sin, cos, tan, asin, acos, atan, atan2: .trig(3M) 

help: askforhelp.help(l) 

output, a.out: assembler and link editor .a.out(5) 

as: assembler for PDP-11.as.pdp(l) 

microprocessor, kas: assembler for the KMCll.kas(l) 

as: assembler for VAX-11/780.as.vax(l) 

assert: program verification.assert(3X) 

setbuf: assign buffering to a stream.setbuf(3S) 

kl: KL-11 or DL-11 asynchronous interface.kl(4) 

/dh: DZ-11, DZ-ll/KMC-11, DH-11 asynchronous multiplexers.dz(4) 

dj:DJ-ll asynchronous multiplexor.dj(4) 

sin, cos, tan, asin, acos, atan, atan2: trigonometric/.trig(3M) 

cos, tan, asin, acos, atan, atan2: trigonometric/ sin, .trig(3M) 

ASCII to numbers, atof, atoi, atol: convert .atof(3C) 

numbers, atof, atoi, atol: convert ASCII to .atof(3C) 

numbers, atof, atoi, atol: convert ASCII to .atof(3C) 

wait: await completion of process.wait(l) 

processing language, awk: pattern scanning and.awk(l) 

ungetc: push character back into input stream.ungetc(3S) 

back: the game of backgammon.back(6) 

back: the game of backgammon.back(6) 

daily/weekly UNIX file system backup, filesave, tapesave:.filesave(8) 

banner: make posters.banner(l) 

164a: convert between long and base-64 ASCII. a641.a641(3C) 

portions of path names, basename, dimame: deliver .basename(l) 

arithmetic language, be: arbitrary-precision.bc(l) 

bcopy: interactive block copy.bcopy(lM) 

bdiff: big diff..bdiff(l) 

cb: C program beautifier.cb(l) 

jO, jl, jn, yO, yl, yn: bessel functions.bessel(3M) 

bfs: big file scanner. .bfs(l) 

fread, fwrite: buffered binary input/output.fread(3S) 

bsearch: binary search.bsearch(3C) 

remove symbols and relocation bits, strip: .strip(l) 

bj: the game of blackjack.bj(6) 

bj: the game of blackjack.bj(6) 

bcopy: interactive block copy.bcopy(lM) 

sync: update the super block..sync(lM) 

df: report number of free disk blocks.df(l) 

sum: sum and count blocks in a file.sum(l) 

unixboot: UNIX startup and boot procedures..unixboot(8) 

romboot: special ROM bootstrap loaders.romboot(8) 

70boot: 11/70 bootstrap procedures.70boot(8) 

tapeboot: magnetic tape bootstrap program.tapeboot(8) 

diskboot: disk bootstrap programs.diskboot(8) 

space allocation, brk, sbrk: change data segment.brk(2) 
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modest-sized programs, bs: a compiler/interpreter for.bs(l) 

DQS-11 interface for two-point BSC. dqs; .dqs(4) 

bsearch: binary search.bsearch(3C) 

fread, fwrite: buffered binary input/output.fread(3S) 

stdio; standard buffered input/output package.stdio(3S) 

setbuf; assign buffering to a stream.setbuf(3S) 

mknod; build special file..mknod(lM) 

dmc: communications link with built-in DDCMP protocol.dmc(4) 

swab; swap bytes.swab(3C) 

cc, pcc: C compiler..cc(l) 

programs, see: C compiler for stand-alone.scc(l) 

cb; C program beautifier..cb(l) 

lint; a C program checker.lint(l) 

xref: cross reference for C programs.xref(l) 

cal: print calendar.cal(l) 

dc; desk calculator. .dc(l) 

cal: print calendar.cal(l) 

calendar: reminder service.calendar( 1) 

cu; call another UNIX system.cu(lC) 

data returned by stat system call, stat:.stat(7) 

ct; call terminal.ct(lC) 

malloc, free, realloc, calloc: main memory allocator.malloc(3C) 

intro; introduction to system calls and error numbers.intro(2) 

link and unlink system calls, link, unlink; exercise .link(lM) 

pnch; file format for card images.pnch(5) 

files, cat; concatenate and print .cat(l) 

interface, cat; phototypesetter.cat(4) 

cb; C program beautifier.cb(l) 

cc, pcc; C compiler. .cc(l) 

cd; change working directory.cd(l) 

commentary of an sees delta, ede; change the delta.cdc(l) 

floor, ceiling,/floor, fabs, ceil, fmod: absolute value,.floor(3M) 

/fmod: absolute value, floor, ceiling, remainder functions.floor(3M) 

delta: make a delta (change) to an SeeS file.delta(l) 

pipe: create an interprocess channel.pipe(2) 

stream, ungetc: push character back into input .ungetc(3S) 

/isgraph, iscntrl, isascii: character classification.ctype(3C) 

and neqn. eqnchar: special character definitions for eqn .eqnchar(7) 

user, cuserid: character login name of the .cuserid(3S) 

/getchar, fgetc, getw: get character or word from stream.getc(3S) 

/putchar, fputc, putw: put character or word on a stream.putc(3S) 

ascii: map of ASCII character set.ascii(7) 

toupper, tolower, toascii: character translation.conv(3C) 

tr: translate characters.tr(l) 

directory, chdir: change working .chdir(2) 

fsck: file system consistency check and interactive repair.fsck(lM) 

rp6fmt: format and/or check RP06 disk packs.rp6frat(8) 

eqn delimiters, mmchek: check usage of mm macros and.mmchek(l) 

constant-width text for/cw, checkew: prepare .cw(l) 

text for nroff or/eqn, neqn, checkeq: format mathematical .eqn(l) 

lint; a C program checker.lint(l) 

grpek: password/group file checkers, pwck,.pwck(lM) 

copy file systems with label checking, volcopy, labelit:.volcopy(lM) 

systems processed by fsck. checklist; list of file .checklist(5) 

chess; the game of chess.chess(6) 

chess; the game of chess.chess(6) 

chown, chgrp; change owner or group.chown(l) 

times: get process and child process times.times(2) 

terminate, wait: wait for child process to stop or.wait(2) 

chmod: change mode.chmod(l) 

chmod: change mode of file.chmod(2) 

of a file, chown: change owner and group .chown(2) 

group, chown, chgrp: change owner or.chown(l) 

chroot; change root directory.chroot(2) 

foracommand. chroot: change root directory.chroot(lM) 

iscntrl, isascii; character classification, /isgraph,.ctype(3C) 

uuclean; uucp spool directory clean-up.uuclean(lM) 

cki: clear i-node.clri(lM) 

status/ ferror, feof, clearerr, fileno: stream .ferror(3S) 

alarm; set a process’s alarm clock.alarm(2) 

cron; clock daemon.cron(lM) 

close; close a file descriptor.close(2) 
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descriptor, close: close a file.close(2) 

fclose, fflush: close or flush a stream.fcIose(3S) 

clri: clear i-node..clri(lM) 

cmp: compare two files.cmp(l) 

line-feeds, col: filter reverse.col(l) 

comb: combine sees deltas.comb(l) 

comb: combine SeeS deltas.comb(l) 

common to two sorted files, comm: select or reject lines .comm(l) 

activity/timex: time a command and generate a system .timex(l) 

nice: run a command at low priority.nice(l) 

change root directory for a command, chroot:.chroot(lM) 

env: set environment for command execution.env(l) 

uux: Unix to Unix command execution.uux(ie) 

quits, nohup: run a command immune to hangups and.nohup(l) 

rsh: restricted shell (command interpreter).rsh(l) 

getopt: parse command options.getopt(l) 

sh: shell, the standard command programming language.sh(l) 

per-process/acetems: command summary from .acctcms(lM) 

system: issue a shell command.system(3S) 

test: condition evaluation command.test(l) 

time: time a command.time(l) 

argument list(s) and execute command, xargs: construct .xargs(l) 

and miscellaneous accounting commands./of accounting.acct(lM) 

intro: introduction to commands and application/ .intro(l) 

access graphical and numerical commands, graphics:.graphics(lG) 

install: install commands.install(lM) 

how to remake the system and commands, mk:.mk(8) 

network useful with graphical commands, stat: statistical.stat(lG) 

ede: change the delta commentary of an SCCS delta.cdc(l) 

comm: select or reject lines common to two sorted files.comm(l) 

pci: parallel communications link interface.pcl(4) 

built-in DDCMP protocol, dmc: communications link with.dmc(4) 

diff: differential file comparator.diff(l) 

cmp: compare two files.cmp(l) 

SCCS file, scesdiff: compare two versions of an .sccsdiff(l) 

diff3: 3-way differential file comparison.diff3(l) 

diremp: directory comparison.dircmp(l) 

regexp: regular expression compile and match routines.regexp(7) 

regemp: regular expression compile.regcmp(l) 

regemp: regular expression compile/execute, regex.regex(3X) 

cc, pcc: C compiler.cc(l) 

f77: Fortran 77 compiler.f77(l) 

programs, see: C compiler for stand-alone.scc(l) 

protocol machine, vpmc: compiler for the virtual.vpmc(lC) 

yacc: yet another compiler-compiler.yacc(l) 

modest-sized programs, bs: a compiler/interpreter for.bs(l) 

wait: await completion of process.wait(l) 

pack, peat, unpack: compress and expand files.pack(l) 

cat: concatenate and print files.cat(l) 

test: condition evaluation command.test(l) 

system, config: configure a UNIX .config(lM) 

config: configure a UNIX system.config(lM) 

acctcon: connect-time accounting.acctcon(lM) 

interactive/fsck: file system consistency check and .fsck(lM) 

vlx: VAX-11/780 LSI console floppy interface.vlx(lM) 

vaxops: VAX-11/780 console operations.vaxops(8) 

report and interactive status console, rjestat: RJE status.ijestat(lC) 

cw, checkew: prepare constant-width text for troff..cw(l) 

mkfs: construct a file system.mkfs(lM) 

execute command, xargs: construct argument list(s) and.xargs(l) 

nroff/troff, tbl, and eqn constructs, deroff: remove.deroff(l) 

Is: list contents of directories.ls(l) 

toe: graphical table of contents routines.toc(lG) 

esplit: context split.csplit(l) 

ioctl: control device.ioctl(2) 

fcntl: file control.fcntl(2) 

inittab: control information for init.inittab(5) 

init: process control initialization.init(8) 

fcntl: file control options.fcntl(7) 

st: synchronous terminal control.st(lM) 

uucp status inquiry and job control, uustat: .uustat(lC) 

vc: version control.vc(l) 
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term: conventional names.term(7) 

ecvt, fcvt: output conversion..ecvt(3C) 

units: conversion program. .units(l) 

sscanf: formatted input conversion, scanf, fscanf,.scanf(3S) 

dd: convert and copy a file.dd(l) 

PDP-11 to VAX-11/780/arcv: convert archive files from.arcv(l) 

atof, atoi, atol: convert ASCII to numbers.atof(3C) 

integers and/13tol, ltol3: convert between 3-byte.13tol(3C) 

base-64 ASCII. a641,164a: convert between long and.a641(3C) 

/gmtime, asctime, tzset: convert date and time to/ .ctime(3C) 

and VAX-11/780 systems, fscv: convert files between PDP-11 .fscv(lM) 

dd: convert and copy a file..dd(l) 

bcopy: interactive block copy.bcopy(lM) 

cpio: copy file archives in and out.cpio(l) 

checking, volcopy, labeht: copy file systems with label .volcopy(lM) 

cp, In, mv: copy, link or move files.cp(l) 

uulog, uuname: unix to unix copy, uucp,.uucp(lC) 

public UNIX-to-UNIX file copy, uuto, uupick: .uuto(lC) 

file, core: format of core image.core(5) 

core: format of core image file. .core(5) 

mem, kmem: core memory.mem(4) 

atan2: trigonometric/ sin, cos, tan, asin, acos, atan,.trig(3M) 

functions, sinh, cosh, tanh: hyperbolic.sinh(3M) 

sum: sum and count blocks in a file.sum(l) 

wc: word count..wc(l) 

files, cp, In, mv: copy, link or move .cp(l) 

cpio: format of cpio archive.cpio(5) 

and out. cpio: copy file archives in.cpio(l) 

cpio: format of cpio archive.cpio(5) 

craps: the game of craps.craps(6) 

craps: the game of craps.craps(6) 

crash: examine system images.crash(lM) 

system crashes, crash: what to do when the.crash(8) 

what to do when the system crashes, crash: .crash(8) 

rewrite an existing one. creat: create a new file or .creat(2) 

file, tmpnam: create a name for a temporary .tmpnam(3S) 

an existing one. creat: create a new file or rewrite.creat(2) 

fork: create a new process.fork(2) 

tmpfile: create a temporary file.tmpfile(3S) 

channel, pipe: create an interprocess.pipe(2) 

files, admin: create and administer SCCS .admin(l) 

umask: set and get file creation mask.umask(2) 

listing, cref: make cross-reference.cref(l) 

cron: clock daemon.cron(lM) 

programs, xref: cross reference for C.xref(l) 

cref: make cross-reference listing.cref(l) 

crypt: encode/decode.crypt(l) 

encryption, crypt, setkey, encrypt: DES .crypt(3C) 

csplit: context split.csplit(l) 

ct: call terminal.ct(lC) 

for terminal, ctermid: generate file name.ctermid(3S) 

asctime, tzset: convert date/ ctime, localtime, gmtime, .ctime(3C) 

cu: call another UNIX system.cu(lC) 

ttt, cubic: tic-tac-toe.ttt(6) 

activity, sact: print current SCCS file editing .sact(l) 

uname: get name of current UNIX system.uname(2) 

uname: print name of current UNIX.uname(I) 

spline: interpolate smooth curve..spline(lG) 

of the user, cuserid: character login name.cuserid(3S) 

of each line of a file, cut: cut out selected fields.cut(l) 

each line of a file, cut: cut out selected fields of.cut(l) 

constant-width text for/ cw, checkcw: prepare.cw(l) 

cron: clock daemon.cron(lM) 

sending daemons, line printer daemon./odpd, Ipd: HONEYWELL.dpd(lC) 

errdemon: error-logging daemon.errdemon(lM) 

terminate the error-logging daemon, errstop: .errstop(lM) 

fget.odemon: file retrieval daemons, fget.demon, .fget.demon(lC) 

/odpd, Ipd: HONEYWELL sending daemons, line printer daemon.dpd(lC) 

runacct: run daily accounting.runacct(lM) 

backup, filesave, tapesave: daily/weekly UNIX file system.filesave(8) 

/handle special functions of DASI 300 and 300s terminals. 300(1) 

special functions of the DASI 450 terminal./handle. 450(1) 
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prof: display profile data. .prof(l) 

call, stat: data returned by stat system .stat(7) 

brk, sbrk: change data segment space allocation.brk(2) 

types: primitive system datatypes.types(7) 

join: relational database operator.join(l) 

/asctime, tzset: convert date and time to ASCII.ctime(3C) 

date: print and set the date. .date(l) 

date: print and set the date.date(l) 

dc: desk calculator.dc(l) 

dd: convert and copy a file.dd(l) 

/link with built-in DDCMP protocol.dmc(4) 

adb: debugger.adb(l) 

fsdb: file system debugger.fsdb(lM) 

sdb: symbolic debugger.sdb(l) 

sysdef: system definition. .sysdef(lM) 

eqnchar: special character definitions for eqn and neqn.eqnchar(7) 

usage of mm macros and eqn delimiters, mmchek: check .mmchek(l) 

names, basename, dimame: deliver portions of path.basename(l) 

file, tail: deliver the last part of a.tail(l) 

delta commentary of an sees delta, ede: change the.cdc(l) 

file, delta: make a delta (change) to an SCCS.delta(l) 

delta, ede: change the delta commentary of an SCCS .cdc(l) 

rmdel: remove a delta from an SCCS file.rmdel(l) 

to an SCCS file, delta: make a delta (change) .delta(l) 

comb: combine SCCS deltas.comb(l) 

mesg: permit or deny messages. .mesg(l) 

tbl, and eqn constructs, deroff: remove nroff/troff,.deroff(l) 

crypt, setkey, encrypt: DES encryption.crypt(3C) 

close: close a file descriptor.close(2) 

dup: duplicate an open file descriptor.dup(2) 

dc: desk calculator.dc(l) 

file, access: determine accessibility of a .access(2) 

file: determine file type.file(l) 

master: master device information table.master(5) 

ioctl: control device.ioctl(2) 

devnm: device name.devnm(lM) 

/tekset, td: graphical device routines and filters.gdev(lG) 

devnm: device name.devnm(lM) 

blocks, df: report number of free disk.df(l) 

asynchronous/dz, dzk, dh: DZ-11, DZ-ll/KMC-11, DH-11.dz(4) 

dzk, dh:DZ-ll,DZ-ll/KMC-ll, DH-11 asynchronous/dz.dz(4) 

ratfor: rational Fortran dialect.ratfor(l) 

bdiff:big diff..bdiff(l) 

comparator, diff: differential file .diff(l) 

comparison. diff3: 3-way differential file .diff3(l) 

sdiff: side-by-side difference program.sdiff(l) 

diffmk: mark differences between files.diffmk(l) 

diff: differential file comparator.diff(l) 

diff3: 3-way differential file comparison.diff3(l) 

between files, diffmk: mark differences .diffmk(l) 

dir: format of directories.dir(5) 

diremp: directory comparison.dircmp(l) 

dir: format of directories.dir(5) 

Is: list contents of directories.ls(l) 

rm, rmdir: remove files or directories.rm(l) 

cd: change working directory.cd(l) 

chdir: change working directory.chdir(2) 

chroot: change root directory.chroot(2) 

uuclean: uucp spool directory clean-up.uuclean(lM) 

diremp: directory comparison.dircmp(l) 

unlink: remove directory entry.unlink(2) 

chroot: change root directory for a command.chroot(lM) 

mkdir: make a directory.mkdir(l) 

mvdir: move a directory.mvdir(lM) 

pwd: working directory name.pwd(l) 

ordinary file, mknod: make a directory, or a special or.mknod(2) 

path names, basename, dimame: deliver portions of .basename(l) 

acet: enable or disable process accounting.acct(2) 

df: report number of free diskblocks.df(l) 

diskboot: disk bootstrap programs.diskboot(8) 

RH11/RJS03-RJS04 fixed-head disk file, hs: .hs(4) 

rf:RFll/RSll fixed-head disk file.rf(4) 
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moving-head 
format and/or check RP06 
rk: RK-11/RK03 orRKOS 
rl:RL-ll/RL01 
rp: RP-11/RP03 moving-head 
du: summarize 
programs, 
mount, umount; mount and 
prof; 

hypot: Euclidean 
multiplexor, 
multiplexor, dj: 
kl; KL-llor 
built-in DDCMP protocol. 

dn; 

MM macros, mm; print out 
macro package for formatting 
slides, mmt, mvt: typeset 
whodo; who is 
sending daemons, line printer/ 

two-point BSC. 
BSC. dqs; 
reversi; a game of 
graph; 

arithmetic: provide 
trace: event-tracing 
interface. 

interface, du: 
dump; incremental file system 
extract error records from 
format, 
dump, 
od: octal 
dump; incremental 
descriptor, 
descriptor, dup: 
DZ-11/KMC-11,DH-11/ 
asynchronous/ dz, dzk, dh: 

dz, dzk, dh:DZ-ll, 
DH-11 asynchronous/ dz, 
echo; 


program, end, etext, 
sact: print current SCCS file 
ed: text 
ged: graphical 
Id: link 
sed; stream 
/user, real group, and 
and/ /getegid: get real user. 
Language, 
for a pattern, grep, 
accounting, acct: 

crypt; 
crypt, setkey, 
crypt, setkey, encrypt; DES 
makekey: generate 
locations in program, 
/getgrgid, getgmam, setgrent, 
/getpwuid, getpwnam, setpwent, 
rjestat: RJE status and 
nlist: get 
man; print 
man: macros for formatting 
utmp, wtmp: utmp and wtmp 
endgrent: get group file 
endpwent: get password file 


disk. /RP04/RP05/RP06 . . 

disk packs. rp6fmt;. 

disk. 

disk. 

disk. 

disk usage. 

diskboot: disk bootstrap . . . 

dismount file system. 

display profile data. 

distance. 

dj: DJ-11 asynchronous . . . 
DJ-11 asynchronous .... 
DL-11 asynchronous interface, 
dmc: communications link with 
dn: DN-11 ACU interface. . . 
DN-11 ACU interface. . . . 
documents formatted with the 
documents, mm: the MM . . 
documents, view graphs, and . 

doing what.. 

dpd, odpd, Ipd; HONEYWELL 

dpr: off-line print. 

dqs: DQS-11 interface for . . 
DQS-11 interface for two-point 

dramatic reversals. 

draw a graph. 

drill in number facts. 

driver. 

du: DU-11 synchronous line 
du: summarize disk usage. . . 
DU-11 synchronous line . . . 

dump. 

dump, errdead: . 

dump: incremental dump tape 
dump: incremental file system 

dump. 

dump tape format. 

dup; duplicate an open file . . 
duplicate an open file .... 

dz,dzk,dh;DZ-ll,. 

DZ-11, DZ-11/KMC-11, DH-11 
DZ-ll/KMC-11,DH-11/ . . 

dzk, dh; DZ-11, DZ-11 /KMC-11, 

echo arguments. 

echo: echo arguments. . . . 
ecvt, fcvt; output conversion. . 

ed: text editor. 

edata; last locations in ... 

editing activity. 

editor. 

editor. 

editor. 

editor. 

effective group IDs. 

effective user, real group, . . 
efl: Extended Fortran .... 
egrep, fgrep: search a file . . 
enable or disable process . . 

encode/decode. . 

encrypt; DES encryption. . . 

encryption. 

encryption key. . 

end, etext, edata: last .... 
endgrent: get group file/ . . . 
endpwent; get password file/ . 

enquiries. 

entries from name list. . . . 

entries in this manual. 

entries in this manual. 

entry format. 

entry, /getgmam, setgrent, . . 
entry, /getpwnam, setpwent, . 


hp(4) 

rp6fmt(8) 

rk(4) 

rl(4) 

rp(4) 

du(l) 

diskboot(8) 

mount(lM) 

prof(l) 

hypot(3M) 

dj(4) 

dj(4) 

kl(4) 

dmc(4) 

dn(4) 

dn(4) 

mm(l) 

mm(7) 

mmt(l) 

whodo(lM) 

dpd(lC) 

dpr(lC) 

dqs(4) 

dqs(4) 

reversi(6) 

graph(lG) 

arithmetic(6) 

trace(4) 

du(4) 

du(l) 

du(4) 

dump(lM) 

errdead(lM) 

dump(5) 

dump(lM) 

odd) 

dump(5) 

dup(2) 

dup(2) 

dz(4) 

dz(4) 

dz(4) 

dz(4) 

echo(l) 

echo(l) 

ecvt(3C) 

ed(l) 

end(3C) 

sact(l) 

ed(l) 

ged(lG) 

ld(l) 

sed(l) 

getuid(2) 

getuid(2) 

efl(l) 

grep(l) 

acct(2) 

crypt(l) 

crypt(3C) 

crypt(3C) 

makekey(8) 

end(3C) 

getgrent(3C) 

getpwent(3C) 

orjestat(lC) 

nlist(3C) 

man(l) 

man(7) 

utmp(5) 

getgrent(3C) 

getpwent(3C) 
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putpwent: write password file entry.putpwent(3C) 

hasp: RJE (Remote Job Entry) to IBM.hasp(8) 

rje: RJE (Remote Job Entry) to IBM.ije(8) 

uvac: RJE (Remote Job Entry) to UNIVAC.uvac(8) 

unlink: remove directory entry..unlink(2) 

command execution, env: set environment for.env(l) 

environ: user environment.environ(7) 

profile: setting up an environment at login time.profile(5) 

environ: user environment.environ(7) 

execution, env: set environment for command.env(l) 

getenv: value for environment name.getenv(3C) 

sky: obtain ephemerides.sky(6) 

character definitions for eqn and neqn. /special .eqnchar(7) 

remove nroff/troff, tbl, and eqn constructs, deroff: .deroff(l) 

check usage of mm macros and eqn delimiters, mmchek: .mmchek(l) 

mathematical text for nroff/ eqn, neqn, checkeq: format.eqn(l) 

definitions for eqn and neqn. eqnchar: special character.eqnchar(7) 

etp: Equipment Test Package.etp(8) 

graphical device/hpd, erase, hardcopy, tekset, td:.gdev(lG) 

err: error-logging interface.err(4) 

fromdump. errdead: extract error records.errdead(lM) 

daemon, errdemon: error-logging.errdemon(lM) 

format, errfile: error-log file .errfile(5) 

perror, sys_errlist, sys_nerr, ermo: system error messages.perror(3C) 

sys_nerr, ermo: system error messages. /sys_errlist, .perror(3C) 

to system calls and error numbers, /introduction.intro(2) 

errdead: extract error records from dump.errdead(lM) 

errfile: error-log file format.errfile(5) 

errdemon: error-logging daemon.errdemon(lM) 

errstop: terminate the error-logging daemon.errstop(lM) 

err: error-logging interface.err(4) 

process a report of logged errors, errpt: .errpt(lM) 

spellout: find spelling errors, spell, spellin.spell(l) 

find possible typographical errors, typo: .typo(l) 

logged errors, errpt: process a report of.errpt(lM) 

error-logging daemon, errstop: terminate the.errstop(lM) 

setmnt: establish mnttab table.setmnt(lM) 

in program, end, etext, edata: last locations.end(3C) 

etp: Equipment Test Package.etp(8) 

hypot: Euclidean distance.hypot(3M) 

expression, expr: evaluate arguments as an .expr(l) 

test: condition evaluation command.test(l) 

trace: event-tracing driver.trace(4) 

crash: examine system images.crash(lM) 

execlp, execvp: execute a/ excel, execv, execle, execve,.exec(2) 

exeevp: execute/ execl, execv, execle, execve, execlp, .exec(2) 

excel, execv, execle, execve, execlp, execvp: execute a/.exec(2) 

execve, execlp, execvp: execute a file./execle, .exec(2) 

construct argument list(s) and execute command, xargs: .xargs(l) 

set environment for command execution, env: .env(l) 

sleep: suspend execution for an interval.sleep(l) 

sleep: suspend execution for interval.sleep(3C) 

monitor: prepare execution profile.monitor(3C) 

profil: execution time profile.profil(2) 

uux: Unix to unix command execution. .uux(lC) 

execvp: execute a/ execl, execv, execle, execve, execlp, .exec(2) 

execute/ execl, execv, execle, execve, execlp, execvp:.exec(2) 

/execv, execle, execve, execlp, execvp: execute a file..exec(2) 

system calls, link, unlink: exercise link and unlink.link(lM) 

a new file or rewrite an existing one. creat: create.creat(2) 

exit: terminate process.exit(2) 

exponential, logarithm,/ exp, log, pow, sqrt:.exp(3M) 

peat, unpack: compress and expand files, pack.pack(l) 

modf: split into mantissa and exponent, frexp, Idexp,.frexp(3C) 

square/ exp, log, pow, sqrt: exponential, logarithm, power.exp(3M) 

expression, expr: evaluate arguments as an.expr(l) 

routines, regexp: regular expression compile and match .regexp(7) 

regemp: regular expression compile.regcmp(l) 

regex, regemp: regular expression compile/execute.regex(3X) 

expr: evaluate arguments as an expression.expr(l) 

efl: Extended Fortran Language.efl(l) 

greek: graphics for the extended TTY-37 type-box.greek(7) 
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dump, errdead: extract error records from .errdead(lM) 

f77; Fortran 77 compiler.f77(l) 

value, floor, ceiling,/ floor, fabs, ceil, fmod: absolute .floor(3M) 

large primes, factor, primes: factor a number, generate .factor(l) 

number, generate large/ factor, primes: factor a .factor(l) 

true, false: provide truth values.true(l) 

abort: generate an lOT fault. .abort(3C) 

a stream, fclose, fflush: close or flush .fclose(3S) 

fcntl: file control.fcntl(2) 

fcntl: file control options.fcntl(7) 

ecvt, fcvt: output conversion.ecvt(3C) 

fopen, freopen, fdopen: open a stream.fopen(3S) 

status inquiries, ferror, feof, clearerr, flleno: stream .ferror(3S) 

fileno: stream status/ ferror, feof, clearerr.ferror(3S) 

stream, fclose, fflush: close or flush a.fclose(3S) 

HONEYWELL 6000. fget: retrieve files from the.fget(lC) 

word from/getc, getchar, fgetc, getw: get character or .getc(3S) 

retrieval daemons, fget.demon, fget.odemon: file.fget.demon(lC) 

daemons, fgetdemon, fget.odemon: file retrieval.fget.demon(lC) 

stream, gets, fgets: get a string from a.gets(3S) 

pattern, grep, egrep, fgrep: search a file for a.grep(l) 

times, utime: set file access and modification .utime(2) 

determine accessibility of a file, access:.access(2) 

tar: tape file archiver.tar(l) 

cpio:copy file archives in and out.cpio(l) 

pwck, grpck: password/group file checkers.pwck(lM) 

chmod: change mode of file.chmod(2) 

change owner and group of a file, chown: .chown(2) 

diff: differential file comparator..diff(l) 

difB: 3-way differential file comparison.diff3(l) 

fcntl: file control.fcntl(2) 

fcntl: file control options.fcntl(7) 

uupick: public UNIX-to-UNIX file copy, uuto, .uuto(lC) 

core: format of core image file.core(5) 

umask: set and get file creation mask.umask(2) 

fields of each line of a file, cut: cut out selected .cut(l) 

dd: convert and copy a file.dd(l) 

a delta (change) to an sees file, delta: make.delta(l) 

close: close a file descriptor.close(2) 

dup: duplicate an open file descriptor.dup(2) 

file: determine file type.file(l) 

sact: print current sees file editing activity.sact(l) 

setgrent, endgrent: get group file entry./getgmam.getgrent(3e) 

endpwent: get password file entry./setpwent.getpwent(3e) 

putpwent: write password file entry.putpwent(3e) 

execlp, exeevp: execute a file, /exeev, execle, exeeve.exec(2) 

grep, egrep, fgrep: search a file for a pattern..grep(l) 

acet: per-process accounting file format.acct(5) 

ar: archive file format.ar(5) 

errfile: error-log file format..errfile(5) 

pnch: file format for card images.pnch(5) 

intro: introduction to file formats.intro(5) 

get: get a version of an sees file.get(l) 

group: group file.group(5) 

fixed-head disk file, hs: RH11/RJS03-RJS04.hs(4) 

split: split a file into pieces.split(l) 

link: link to a file.link(2) 

mknod: build special file.mknod(lM) 

or a special or ordinary file, /make a directory, .mknod(2) 

ctermid: generate file name for terminal.ctermid(3S) 

mktemp: make a unique filename.mktemp(3e) 

null: the null file.null(4) 

one. creat: create a new file or rewrite an existing .creat(2) 

passwd: password file.passwd(5) 

or subsequent fines of one file./lines of several files .paste(l) 

Iseek: move read/write file pointer.lseek(2) 

prs: print an SCCS file.prs(l) 

read: read from file.read(2) 

reform: reformat text file.reform(l) 

fget.demon, fget.odemon: file retrieval daemons.fget.demon(lC) 

rf:RFll/RSll fixed-head disk file.rf(4) 

remove a delta from an SCCS file, rmdel:.rmdel(l) 
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bfs; big file scanner.bfs(l) 

two versions of an sees file, scesdiff; compare .sccsdiff(l) 

scesfile; format of SeeS file.sccsfile(5) 

size; size of an object file.size(l) 

stat, fstat: get file status.stat(2) 

sum; sum and count blocks in a file.sum(l) 

tapesave; daily/weekly UNIX file system backup, filesave,.filesave(8) 

and interactive repair, fsck; file system consistency check.fsck(lM) 

fsdb; file system debugger..fsdb(lM) 

dump; incremental file system dump.dump(lM) 

volume, file system; format of system.fs(5) 

mkfs: construct a filesystem.mkfs(lM) 

umount; mount and dismount file system, mount,.mount(lM) 

mount; mount a file system.mount(2) 

restor; incremental file system restore.restor(lM) 

ustat; get file system statistics.ustat(2) 

mnttab; mounted file system table.mnttab(5) 

umount: unmount a file system.umount(2) 

fsck. checklist; list of file systems processed by .checldist(5) 

volcopy, labelit: copy file systems with label/ .volcopy(lM) 

deliver the last part of a file, tail;.tail(l) 

tmpfile; create a temporary file.tmpfile(3S) 

create a name for a temporary file, tmpnam:.tmpnam(3S) 

and modification times of a file, touch: update access .touch(l) 

file: determine file type.file(l) 

undo a previous get of an sees file, unget:.unget(l) 

report repeated lines in a file, uniq; .uniq(l) 

val; validate SeeS file.val(l) 

write: write on a file.write(2) 

umask: set file-creation mode mask.umask(l) 

ferror, feof, clearerr, fileno: stream status/.ferror(3S) 

and print process accounting file(s). acctcom: search.acctcom(l) 

merge or add total accounting files, acetmerg; .acctmerg(lM) 

create and administer sees files, admin; .admin(l) 

send, gath: gather files and/or submit RJE jobs.send(ie) 

VAX-11/780/ fsev; convert files between PDP-11 and.fscv(lM) 

cat: concatenate and print files.cat(l) 

emp: compare two files.cmp(l) 

lines common to two sorted files, comm; select or reject .comm(l) 

cp, In, mv: copy, link or move files.cp(l) 

mark differences between files, diffmk;.diffmk(l) 

find; find files.find(l) 

arev; convert archive files from PDP-11 to/.arcv(l) 

fget: retrieve files from the HONEYWELL 6000.fget(lC) 

format specification in text files, fspec:.fspec(5) 

string, format of graphical files./graphical primitive .gps(5) 

intro; introduction to special files.intro(4) 

rm, rmdir; remove files or directories.rm(l) 

/merge same lines of several files or subsequent lines of/ .paste(l) 

unpack: compress and expand files, pack, peat,.pack(l) 

pr; print files.pr(l) 

sort: sort and/or merge files.sort(l) 

fsend:send files to the HONEYWELL 6000.fsend(lC) 

what: identify SCCS files.what(l) 

daily/weekly UNIX file system/ filesave, tapesave: .filesave(8) 

greek; select terminal filter.greek(l) 

nl: line numbering filter. .nl(l) 

col; filter reverse line-feeds.col(l) 

graphical device routines and filters./tekset, td: .gdev(lG) 

tplot; graphics filters.tplot(lG) 

find: find files.find(l) 

find: find files.find(l) 

hyphen; find hyphenated words.hyphen(l) 

ttyname, isatty: find name of a terminal.ttyname(3C) 

object library, lorder: find ordering relation for an .lorder(l) 

errors, typo: find possible typographical.typo(l) 

spell, spellin, spellout: find spelling errors.spell(l) 

tee: pipe fitting.tee(l) 

hs;RHll/RJS03-RJS04 fixed-head disk file. .hs(4) 

rf:RFll/RSll fixed-head disk file. .rf(4) 

fptrap: floating point interpreter.fptrap(3X) 

/ceil, fmod; absolute value, floor, ceiling, remainder/ .floor(3M) 
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absolute value, floor,/ floor, fabs, ceil, fmod: .floor(3M) 

vlx: VAX-11/780 LSI console floppy interface.vlx(lM) 

fclose, fflush; close or flush a stream.fclose(3S) 

ceiling^ floor, fabs, ceil, fmod: absolute value, floor.floor(3M) 

stream, fopen, freopen, fdopen: open a .fopen(3S) 

fork: create a new process.fork(2) 

per-process accounting file format, acct: .acct(5) 

packs. rp6fmt: format and/or check RP06 disk.rp6fmt(8) 

ar: archive file format.ar(5) 

from PDP-11 to VAX-11/780 format./convert archive files.arcv(l) 

dump: incremental dump tape format.dump(5) 

errfile: error-log file format.errfile(5) 

pnch: file format for card images.pnch(5) 

nroff or/eqn, neqn, checkeq: format mathematical text for.eqn(l) 

inode: format of an inode.inode(5) 

core: format of core image file.core(5) 

cpio: format of cpio archive.cpio(5) 

dir: format of directories.dir(5) 

/graphical primitive string, format of graphical files.gps(5) 

sccsfile: format of SCCS file.sccsfile(5) 

file system: format of system volume.fs(5) 

files, fspec: format specification in text.fspec(5) 

troff. tbl: format tables for nroff or .tbl(l) 

troff, nroff: typeset or format text.troff(l) 

tp: magnetic tape format.tp(5) 

wtmp: utmp and wtmp entry format, utmp.utmp(5) 

intro: introduction to file formats.intro(5) 

scanf, fscanf, sscanf: formatted input conversion.scanf(3S) 

mm: print out documents formatted with the MM macros.mm( 1) 

fprintf, sprintf: output formatters, printf, .printf(3S) 

mm: the MM macro package for formatting documents.mm(7) 

manual, man: macros for formatting entries in this.man(7) 

f77: Fortran 77 compiler.f77(l) 

ratfor: rational Fortran dialect. .ratfor(l) 

efl: Extended Fortran Language.efl(l) 

formatters, printf, fprintf, sprintf: output.printf(3S) 

interpreter, fptrap: floating point.fptrap(3X) 

word on a/putc, putchar, fputc, putw: put character or.putc(3S) 

stream, puts, fputs: put a string on a .puts(3S) 

input/output, fread, fwrite: buffered binary.fread(3S) 

df: report number of free disk blocks..df(l) 

memory allocator, malloc, free, realloc, calloc: main .malloc(3C) 

stream, fopen, freopen, fdopen: open a.fopen(3S) 

mantissa and exponent, frexp, Idexp, modf: split into.frexp(3C) 

gets, fgets: get a string from a stream.gets(3S) 

rmdel: remove a delta from an SCCS file.rmdel(l) 

getopt: get option letter fromargv. .getopt(3C) 

errdead: extract error records from dump..errdead(lM) 

read: read from file.read(2) 

ncheck: generate names from i-numbers.ncheck(lM) 

nlist: get entries from name list.nlist(3C) 

arcv: convert archive files from PDP-11 to VAX-11/780/ .arcv(l) 

acctcms: command summary from per-process accounting/.acctcms(lM) 

getw: get character or word from stream, /getchar, fgetc.getc(3S) 

fget: retrieve files from the HONEYWELL 6000.fget(lC) 

getpw: get name from UID.getpw(3C) 

input conversion, scanf, fscanf, sscanf: formatted.scanf(3S) 

of file systems processed by fsck. checklist: list.checklist(5) 

check and interactive repair, fsck: file system consistency.fsck(lM) 

PDP-11 and VAX-11/780/ fscv: convert files between.fscv(lM) 

fsdb: file system debugger.fsdb(lM) 

reposition a stream, fseek, ftell, rewind:.fseek(3S) 

HONEYWELL 6000. fsend: send files to the .fsend(lC) 

text files, fspec: format specification in.fspec(5) 

stat, fstat: get file status.stat(2) 

stream, fseek, ftell, rewind: reposition a .fseek(3S) 

gamma: log gamma function.gamma(3M) 

jO, jl, jn, yO, yl, yn: bessel functions.bessel(3M) 

logarithm, power, square root functions, /sqrt: exponential,.exp(3M) 

floor, ceiling, remainder functions, /absolute value,.floor(3M) 

300, 300s: handle special functions of DASI 300 and 300s/. 300(1) 

hp: handle special functions of HP 2640 and/.hp(l) 
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terminal. 450; handle special functions of the DASI450 . 450(1) 

sinh, cosh, tanh: hyperbolic functions.sinh(3M) 

atan, atan2: trigonometric functions, /tan, asin, acos.trig(3M) 

input/output. fread, fwrite: buffered binary .fread(3S) 

wtmp records, fwtmp, wtmpfix; manipulate.fwtmp(lM) 

moo: guessing game.moo(6) 

back: the game of backgammon.back(6) 

bj:the game of blackjack.bj(6) 

chess: the game of chess.chess(6) 

craps: the game of craps.craps(6) 

reversi: a game of dramatic reversals.reversi(6) 

wump: the game of hunt-the-wumpus.wump(6) 

intro: introduction to games..mtro(6) 

gamma: log gamma function..gamma(3M) 

gamma: log gamma function.gamma(3M) 

submit RJE jobs, send, gath; gather files and/or.send(lC) 

jobs, send, gath: gather files and/or submit RJE .send(lC) 

output to the HONEYWELL 6000. gcat: send phototypesetter.gcat(lC) 

user, gcosmail; send mail to HIS .gcosmail(lC) 

ged; graphical editor.ged(lG) 

maze: generate a maze..maze(6) 

timex: time a command and generate a system activity/.timex(l) 

abort: generate an lOT fault.abort(3C) 

makekey: generate encryption key.makekey(8) 

terminal, ctermid: generate file name for.ctermid(3S) 

/primes; factor a number, generate large primes.factor(l) 

ncheck: generate names from i-numbers.ncheck(lM) 

lexical tasks, lex: generate programs for simple.lex(l) 

rand, srand: random number generator. .rand(3C) 

gets, fgets: get a string from a stream.gets(3S) 

get; get a version of an sees file.get(l) 

ulimit: get and set user limits.ulimit(2) 

getc, getchar, fgetc, getw: get character or word from/ .getc(3S) 

nlist; get entries from name list.nlist(3e) 

umask: set and get file creation mask.umask(2) 

stat, fstat: get file status.stat(2) 

ustat; get file system statistics.ustat(2) 

file, get: get a version of an sees.get(l) 

/getgrnam, setgrent, endgrent: get group file entry. .getgrent(3e) 

getlogin; get login name.getlogin(3e) 

logname: get login name. .logname(l) 

getpw; get name from UID. .getpw(3e) 

system, uname: get name of current UNIX.uname(2) 

unget: undo a previous get of an SeeS file. .unget(l) 

getopt; get option letter from argv.getopt(3e) 

/getpwnam, setpwent, endpwent: get password file entry.getpwent(3e) 

times, times: get process and child process.times(2) 

and/ getpid, getpgrp, getppid: get process, process group,.getpid(2) 

/geteuid, getgid, getegid: get real user, effective user,/.getuid(2) 

tty; get the terminal’s name.tty(l) 

time; get time.time(2) 

get character or word from/ getc, getchar, fgetc, getw: .getc(3S) 

character or word from/ getc, getchar, fgetc, getw; get.getc(3S) 

getuid, geteuid, getgid, getegid: get real user,/.getuid(2) 

name, getenv: value for environment .getenv(3C) 

real user, effective/ getuid, geteuid, getgid, getegid: get .getuid(2) 

user,/ getuid, geteuid, getgid, getegid: get real.getuid(2) 

setgrent, endgrent; get group/ getgrent, getgrgid, getgrnam.getgrent(3C) 

endgrent; get group/ getgrent, getgrgid, getgrnam, setgrent,.getgrent(3C) 

get group/ getgrent, getgrgid, getgrnam, setgrent, endgrent;.getgrent(3C) 

getlogin: get login name.getlogin(3C) 

argv. getopt: get option letter from.getopt(3C) 

getopt: parse command options.getopt(l) 

getpass: read a password.getpass(3C) 

process group, and/getpid, getpgrp, getppid: get process.getpid(2) 

process, process group, and/ getpid, getpgrp, getppid: get.getpid(2) 

group, and/ getpid, getpgrp, getppid: get process, process.getpid(2) 

getpw: get name from UID.getpw(3C) 

setpwent, endpwent: get/ getpwent, getpwuid, getpwnam,.getpwent(3C) 

get/ getpwent, getpwuid, getpwnam, setpwent, endpwent: .getpwent(3C) 

endpwent: get/ getpwent, getpwuid, getpwnam, setpwent,.getpwent(3C) 

a stream, gets, fgets: get a string from .gets(3S) 
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terminal, getty: set the modes of a.getty(8) 

getegid: get real user,/ getuid, geteuid, getgid, .getuid(2) 

from/getc, getchar, fgetc, getw: get character or word .getc(3S) 

convert/ ctime, localtime, gmtime, asctime, tzset: .ctime(3C) 

setjmp, longjmp: non-local goto. .setjmp(3C) 

string, format of graphical/ gps: graphical primitive.gps(5) 

graph: draw a graph.graph(lG) 

graph: draw a graph.graph(lG) 

sag: system activity graph.sag(lM) 

commands, graphics: access graphical and numerical.graphics(lG) 

/network useful with graphical commands.stat(lG) 

/erase, hardcopy, tekset, td: graphical device routines and/ .gdev(lG) 

ged: graphical editor.ged(lG) 

primitive string, format of graphical files./graphical .gps(5) 

format of graphical/gps: graphical primitive string.gps(5) 

routines, toe: graphical table of contents.toc(lG) 

gutil: graphical utilities.gutil(lG) 

numerical commands, graphics: access graphical and .graphics(lG) 

tplot: graphics filters.tplot(lG) 

TTY-37 type-box. greek: graphics for the extended .greek(7) 

plot: graphics interface.plot(5) 

subroutines, plot: graphics interface .plot(3X) 

mvt: typeset documents, view graphs, and slides, mmt, .mmt(l) 

macro package for making view graphs, mv: a.mv(7) 

extended TTY-37 type-box. greek: graphics for the .greek(7) 

greek: select terminal filter.greek(l) 

file for a pattern, grep, egrep, fgrep: search a.grep(l) 

/user, effective user, real group, and effective group/.getuid(2) 

/getppid: get process, process group, and parent process IDs.getpid(2) 

chown, chgrp: change owner or group..chown(l) 

setgrent, endgrent: get group file entry, /getgmam, .getgrent(3C) 

group: group file.group(5) 

group: group file.group(5) 

setpgrp: set process group ID.setpgrp(2) 

id: print user and group IDs and names..id(l) 

real group, and effective group IDs. /effective user.getuid(2) 

setuid, setgid: set user and group IDs.setuid(2) 

newgrp: log in to a new group..newgrp(l) 

chown: change owner and group of a file.chown(2) 

a signal to a process or a group of processes./send .kill(2) 

update, and regenerate groups of programs./maintain.make(l) 

checkers, pwck, grpek: password/group file.pwck(lM) 

ssignal, gsignal: software signals.ssignal(3C) 

hangman: guess the word.hangman(6) 

moo: guessing game.moo(6) 

gutil: graphical utilities.gutil(lG) 

DASI 300 and 300s/ 300, 300s: handle special functions of. 300(1) 

2640 and 2621-series/hp: handle special functions of HP .hp(l) 

the DASI 450 terminal. 450: handle special functions of. 450(1) 

hangman: guess the word.hangman(6) 

nohup: run a command immune to hangups and quits.nohup(l) 

graphical device/hpd, erase, hardcopy, tekset, td: .gdev(lG) 

to IBM. hasp: RJE (Remote Job Entry) .hasp(8) 

help: ask for help.help(l) 

help: ask for help.help(l) 

fget: retrieve files from the HONEYWELL 6000.fget(lC) 

fsend: send files to the HONEYWELL 6000.fsend(lC) 

phototypesetter output to the HONEYWELL 6000. gcat: send .gcat(lC) 

line printer/dpd, odpd, Ipd: HONEYWELL sending daemons,.dpd(lC) 

handle special functions of HP 2640 and 2621-series/hp: .hp(l) 

of HP 2640 and 2621-series/ hp: handle special functions .hp(l) 

moving-head disk, hp: RP04/RP05/RP06.hp(4) 

td: graphical device routines/ hpd, erase, hardcopy, tekset,.gdev(lG) 

fixed-head disk file, hs: RH11/RJS03-RJS04.hs(4) 

interface, ht: TU16 magnetic tape.ht(4) 

wump: the game of hunt-the-wumpus.wump(6) 

sinh, cosh, tanh: hyperbolic functions..sinh(3M) 

hyphen: find hyphenated words.hyphen(l) 

hyphen: find hyphenated words.hyphen(l) 

hypot: Euclidean distance.hypot(3M) 

RJE (Remote Job Entry) to IBM. hasp:.hasp(8) 

ije: RJE (Remote Job Entry) to IBM.ije(8) 
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and names, id: print user and group IDs .id(l) 

setpgrp: set process group ID.setpgrp(2) 

what: identify SCCS files. .what(l) 

id: print user and group IDs and names.id(l) 

group, and parent process IDs./get process, process.getpid(2) 

group, and effective group IDs./effective user, real.getuid(2) 

setgid: set user and group IDs. setuid.setuid(2) 

core: format of core image file.core(5) 

crash: examine system images.crash(lM) 

pnch: file format for card images.pnch(5) 

nohup: run a command immune to hangups and quits.nohup(l) 

dump: incremental dump tape format.dump(5) 

dump: incremental file system dump.dump(lM) 

restore, restor: incremental file system.restor(lM) 

ptx: permuted index..ptx(l) 

control information for init. inittab:.inittab(5) 

initialization, init: process control .init(8) 

init: process control initialization.init(8) 

rc: system initialization shell script.rc(8) 

process, popen, pclose: initiate I/O to/from a.popen(3S) 

for init. inittab: control information.inittab(5) 

cki: clear i-node..clri(lM) 

inode: format of an inode.inodefS) 

inode: format of an inode..inode(5) 

fscanf, sscanf: formatted input conversion, scanf,.scanf(3S) 

push character back into input stream, ungetc:.ungetc(3S) 

fread, fwrite: buffered binary input/output.fread(3S) 

stdio: standard buffered input/output package..stdio(3S) 

fileno: stream status inquiries./feof, clearerr,.ferror(3S) 

uustat: uucp status inquiry and job control.uustat(lC) 

install: install commands.mstall(lM) 

install: install commands.mstall(lM) 

abs: integer absolute value.abs(3C) 

/ltol3: convert between 3-byte integers and long integers.13tol(3C) 

3-byte integers and long integers./convert between.13tol(3C) 

bcopy: interactive block copy.bcopy(lM) 

system consistency check and interactive repair./file .fsck(lM) 

ijestat: RJE status report and interactive status console.ijestat(lC) 

cat: phototypesetter interface.cat(4) 

dn:DN-llACU interface.dn(4) 

du: DU-11 synchronous line interface.du(4) 

err: error-logging interface.err(4) 

dqs:DQS-ll interface for two-point BSC.dqs(4) 

ht: TU16 magnetic tape interface.ht(4) 

KL-11 or DL-11 asynchronous interface, kl: .kl(4) 

parallel communications link interface, pci:.pcl(4) 

plot: graphics interface.plot(5) 

st: synchronous terminal interface.st(4) 

plot: graphics interface subroutines..plot(3X) 

tm: TMl 1/TUlO magnetic tape interface.tm(4) 

tty: general terminal interface.tty(4) 

VAX-11/780 LSI console floppy interface, vlx:.vlx(lM) 

spline: interpolate smooth curve.spline(lG) 

fptrap: floating point interpreter..fptrap(3X) 

rsh: restricted shell (command interpreter).rsh(l) 

sno: SNOBOL interpreter..sno(l) 

pipe: create an interprocess channel.pipe(2) 

suspend execution for an interval, sleep: .sleep(l) 

sleep: suspend execution for interval.sleep(3C) 

commands and application/ intro: introduction to.mtro(l) 

formats, intro: introduction to file.intro(5) 

intro: introduction to games.intro(6) 

miscellany, intro: introduction to.intro(7) 

files, intro: introduction to special.intro(4) 

subroutines and libraries, intro: introduction to.intro(3) 

calls and error numbers, intro: introduction to system.intro(2) 

maintenance procedures, intro: introduction to system.intro(8) 

application programs, intro: introduction to commands and .mtro(l) 

intro: introduction to file formats.intro(5) 

intro: introduction to games.intro(6) 

intro: introduction to miscellany.intro(7) 

intro: introduction to special files.intro(4) 
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and libraries, intro: introduction to subroutines.intro(3) 

and error numbers, intro: introduction to system calls .intro(2) 

maintenance/ intro: introduction to system .intro(8) 

ncheck: generate names from i-numbers.ncheck(lM) 

popen, pclose: initiate I/O to/from a process.popen(3S) 

ioctl: control device. .ioctl(2) 

abort: generate an lOT fault. .abort(3C) 

/islower, isdigit, isxdigit, isalnum, isspace, ispunct,/.ctype(3C) 

isdigit, isxdigit, isalnum,/ isalpha, isupper, islower.ctype(3C) 

isprint, isgraph, iscntrl, isascii: character/ /ispunct.ctype(3C) 

terminal, ttyname, isatty: find name of a.ttyname(3C) 

/ispunct, isprint, isgraph, iscntrl, isascii: character/ .ctype(3C) 

isalpha, isupper, islower, isdigit, isxdigit, isalnum,/ .ctype(3C) 

/isspace, ispunct, isprint, isgraph, iscntrl, isascii:/.ctype(3C) 

isalnum,/ isalpha, isupper, islower, isdigit, isxdigit.ctype(3C) 

/isalnum, isspace, ispunct, isprint, isgraph, iscntrl,/.ctype(3C) 

/isxdigit, isalnum, isspace, ispunct, isprint, isgraph,/ .ctype(3C) 

/isdigit, isxdigit, isalnum, isspace, ispunct, isprint,/.ctype(3C) 

system: issue a shell command.system(3S) 

isxdigit, isalnum,/ isalpha, isupper, islower, isdigit,.ctype(3C) 

/isupper, islower, isdigit, isxdigit, isalnum, isspace,/.ctype(3C) 

news: print news items.news(l) 

functions. jO, jl, jn, yO, yl, yn: bessel.bessel(3M) 

functions. jO, jl, jn, yO, yl, yn: bessel.bessel(3M) 

bj: the game of black jack. .bj(6) 

functions. jO,jl, jn, yO, yl, yn: bessel.bessel(3M) 

operator, join: relational database.join(l) 

microprocessor, kas: assembler for the KMC 11 .kas(l) 

makekey: generate encryption key.makekey(8) 

process or a group of/ kill: send a signal to a.kill(2) 

kill: terminate a process.kill(l) 

asynchronous interface, kl: KL-11 orDL-11 .kl(4) 

interface, kl: KL-11 or DL-11 asynchronous.kl(4) 

kmc: KMCl 1 microprocessor.kmc(4) 

kas: assembler for the KMCl 1 microprocessor.kas(l) 

kmc: KMC 11 microprocessor.kmc(4) 

/vpmsnap, vpmtrace: load the KMCl 1-B; print VPM traces.vpmstart(lC) 

kun: un-assembler for the KMCl 1/DMCl 1 microprocessor.kun(l) 

mem, kmem: core memory..mem(4) 

quiz: test your knowledge.quiz(6) 

KMCll/DMCll microprocessor, kun: un-assembler for the .kun(l) 

3-byte integers and long/ 13tol, ltol3: convert between.13tol(3C) 

base-64 ASCII. a641, 164a: convert between long and.a641(3C) 

copy file systems with label checking./labeht:.volcopy(lM) 

with label checking, volcopy, labelit: copy file systems .volcopy(lM) 

scanning and processing language, awk: pattern .awk(l) 

arbitrary-precisionarithmetic language, be:.bc(l) 

efl: Extended Fortran Language.efl(l) 

standard command programming language, sh: shell, the.sh(l) 

Id: link editor.ld(l) 

mantissa and exponent, frexp, Idexp, modf: split into .frexp(3C) 

getopt: get option letter from argv.getopt(3C) 

simple lexical tasks, lex: generate programs for.lex(l) 

generate programs for simple lexical tasks, lex: .lex(l) 

to subroutines and libraries, /introduction .intro(3) 

relation for an object library./find ordering.lorder(l) 

an archive and library maintainer.ar(l) 

ulimit: get and set user limits.ulimit(2) 

du: DU-11 synchronous line interface.du(4) 

hne: read one line.line(l) 

nl: line numbering filter.nl(l) 

out selected fields of each line of a file, cut: cut.cut(l) 

HONEYWELL sending daemons, line printer daemon./Ipd: .dpd(lC) 

Ip: line printer.lp(4) 

Ipr: line printer spooler.Ipr(l) 

line: read one line.line(l) 

Isearch: linear search and update.lsearch(3C) 

col: filter reverse line-feeds. .col(l) 

files, comm: select or reject lines common to two sorted .comm(l) 

uniq: report repeated lines in a file.uniq(l) 

of several files or subsequent lines of one file./same lines.paste(l) 

subsequent/paste: merge same lines of several files or .paste(l) 
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link, unlink: exercise link and unlink system calls.link(lM) 

Id: linkeditor..ld(l) 

pci: parallel communications link interface.pcl(4) 

link: link to a file.link(2) 

cp, In, mv: copy, link or move files.cp(l) 

link: link to a file.link(2) 

and unlink system calls, link, unlink: exercise link .link(lM) 

protocol, dmc: communications link with built-in DDCMP.dmc(4) 

a.out: assembler and link editor output.a.out(5) 

lint: a C program checker.lint(l) 

Is: list contents of directories.ls(l) 

nlist: get entries from name list.nlist(3C) 

nm: print name list.nm(l) 

by fsck. checklist: list of file systems processed.checkhstfS) 

cref: make cross-reference listing.cref(l) 

xargs: construct argument list(s) and execute command.xargs(l) 

files, cp, In, mv: copy, link or move.cp(l) 

vpmstart, vpmsnap, vpmtrace: load the KMC 11-B; print VPM/.vpmstart(lC) 

romboot: special ROM bootstrap loaders.romboot(8) 

tzset: convert date/ ctime, localtime, gmtime, asctime, .ctime(3C) 

end, etext, edata: last locations in program.end(3C) 

gamma: log gamma function.gamma(3M) 

newgrp: log in to a new group.newgrp(l) 

logarithm, power, square/ exp, log, pow, sqrt: exponential, .exp(3M) 

/log, pow, sqrt: exponential, logarithm, power, square root/ .exp(3M) 

errpt: process a report of logged errors.errpt(lM) 

getlogin: get login name..getlogin(3C) 

logname: get login name..logname(l) 

cuserid: character login name of the user.cuserid(3S) 

logname: login name of user.logname(3X) 

passwd: change login password..passwd(l) 

login: sign on.login(l) 

setting up an environment at login time, profile:.profile(5) 

logname: get login name.logname(l) 

logname: login name of user.logname(3X) 

a641,164a: convert between long and base-64 ASCII.a641(3C) 

between 3-byte integers and long integers./Itol3: convert.13tol(3C) 

setjmp, longjmp: non-local goto.setjmp(3C) 

for an object library, lorder: find ordering relation.lorder(l) 

nice: run a command at low priority.nice(l) 

Ip: line printer.lp(4) 

daemons, line/dpd, odpd, Ipd: HONEYWELL sending.dpd(lC) 

Ipr: line printer spooler.Ipr(l) 

directories. Is: list contents of .ls(l) 

update. Isearch: linear search and .lsearch(3C) 

pointer. Iseek: move read/write file.lseek(2) 

vlx: VAX-11/780 LSI console floppy interface.vlx(lM) 

integers and long/13tol, ltol3: convert between 3-byte.13tol(3C) 

m4: macro processor.m4(l) 

vpm: The Virtual Protocol Machine.vpm(4) 

for the virtual protocol machine, vpmc: compiler.vpmc(lC) 

documents, mm: the MM macro package for formatting.mm(7) 

graphs, mv: a macro package for making view.mv(7) 

m4: macro processor.m4(l) 

mmchek: check usage of mm macros and eqn delimiters.mmchek(l) 

in this manual, man: macros for formatting entries.man(7) 

formatted with the MM macros./print out documents.mm(l) 

program, tapeboot: magnetic tape bootstrap.tapeboot(8) 

tp: magnetic tape format.tp(5) 

ht: TU16 magnetic tape interface.ht(4) 

tm:TMll/TU10 magnetic tape interface.tm(4) 

send mail to users or read mail, mail, rmail: .mail(l) 

users or read mail, mail, rmail: send mail to.mail(l) 

gcosmail: send mail to HIS user.gcosmail(lC) 

mail, rmail: send mail to users or read mail.mail(l) 

malloc, free, realloc, calloc: main memory allocator.malloc(3C) 

regenerate groups of/make: maintain, update, and.make(l) 

an archive and library maintainer..ar(l) 

intro: introduction to system maintenance procedures.intro(8) 

sees file, delta: make a delta (change) to an .delta(l) 

mkdir: make a directory.mkdir(l) 

or ordinary file, mknod: make a directory, or a special.mknod(2) 
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mktemp: make a unique file name.mktemp(3C) 

cref: make cross-reference listing.cref(l) 

regenerate groups of/ make: maintain, update, and.make(l) 

banner: make posters.banner(l) 

key. makekey: generate encryption .makekey(8) 

main memory allocator, malloc, free, realloc, calloc: .malloc(3C) 

entries in this manual, man: macros for formatting .man(7) 

manual, man: print entries in this.man(l) 

tp: manipulate tape archive.tp(l) 

fwtmp, wtmpfix: manipulate wtmp records.fwtmp(lM) 

frexp, Idexp, modf: split into mantissa and exponent.frexp(3C) 

man: print entries in this manual.man(l) 

for formatting entries in this manual, man: macros.man(7) 

ascii: map of ASCII character set.ascii(7) 

files, diffmk: mark differences between.diffmk(l) 

umask: set file-creation mode mask.umask(l) 

set and get file creation mask, umask:.umask(2) 

table, master: master device information.master(5) 

information table, master: master device.master(5) 

regular expression compile and match routines, regexp:.regexp(7) 

eqn, neqn, checkeq: format mathematical text for nroff or/ .eqn(l) 

maze: generate amaze.maze(6) 

maze: generate a maze.maze(6) 

mem, kmem: core memory.mem(4) 

free, realloc, calloc: main memory allocator, malloc,.malloc(3C) 

mem, kmem: core memory.mem(4) 

sort: sort and/or merge files.sort(l) 

files, acctmerg: merge or add total accounting .acctmerg(lM) 

files or subsequent/paste: merge same lines of several .paste(l) 

mesg: permit or deny messages.mesg(l) 

mesg: permit or deny messages.mesg(l) 

sys_nerr,errno: system error messages./sys_errlist.perror(3C) 

kas: assembler for the KMC 11 microprocessor..kas(l) 

kmc:KMCll microprocessor..kmc(4) 

forthe KMCll/DMCll microprocessor./un-assembler.kun(l) 

and commands, mk: how to remake the system .mk(8) 

mkdir: make a directory.mkdir(l) 

mkfs: construct a file system.mkfs(lM) 

mknod: build special file.mknod(lM) 

special or ordinary file, mknod: make a directory, or a .mknod(2) 

name, mktemp: make a unique file .mktemp(3C) 

formatting documents, mm: the MM macro package for.mm(7) 

mmchek: check usage of mm macros and eqn delimiters.mmchek(l) 

documents formatted with the MM macros, mm: print out .mm(l) 

formatted with the MM macros, mm: print out documents .mm(l) 

formatting documents, mm: the MM macro package for .mm(7) 

macros and eqn delimiters, mmchek: check usage of mm.mmchek(l) 

view graphs, and slides, mmt, mvt: typeset documents, .mmt(l) 

table, mnttab: mounted file system.mnttab(5) 

setmnt: establish mnttab table.setmnt(lM) 

chmod: change mode..chmod(l) 

umask: set file-creation mode mask.umask(l) 

chmod: change mode of file.chmod(2) 

getty: set the modes of a terminal.getty(8) 

bs: a compiler/interpreter for modest-sized programs.bs(l) 

exponent, frexp, Idexp, modf: split into mantissa and.frexp(3C) 

touch: update access and modification times of a file.touch(l) 

utime: set file access and modification times.utime(2) 

profile, monitor: prepare execution.monitor(3C) 

uusub: monitor uucp network.uusub(lM) 

moo: guessing game..moo(6) 

mount: mount a file system.mount(2) 

system, mount, umount: mount and dismount file.mount(lM) 

mount: mount a file system.mount(2) 

dismount file system, mount, umount: mount and .mount(lM) 

mnttab: mounted file system table.mnttab(5) 

mvdir: move a directory.mvdir(lM) 

cp, In, mv: copy, link or movefiles.cp(l) 

Iseek: move read/write file pointer.lseek(2) 

hp: RP04/RP05/RP06 moving-head disk.hp(4) 

rp: RP-11/RP03 moving-head disk.rp(4) 

DH-11 asynchronous multiplexers./DZ-11/KMC-11,.dz(4) 
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dj; DJ-11 asynchronous multiplexor.dj(4) 

view graphs, mv; a macro package for making .mv(7) 

cp, In, mv; copy, link or move files.cp(l) 

mvdir: move a directory.mvdir(lM) 

graphs, and slides, mmt, mvt: typeset documents, view .mmt(l) 

i-numbers. ncheck; generate names from.ncheck(lM) 

mathematical text for/eqn, neqn, checkeq: format .eqn(l) 

definitions for eqn and neqn. /special character.eqnchar(7) 

commands, stat; statistical network useful with graphical .stat(lG) 

uusub: monitor uucp network.uusub(lM) 

newgrp: log in to a new group.newgrp(l) 

news; print news items..news(l) 

news; print news items.news(l) 

process, nice; change priority of a .nice(2) 

priority, nice; run a command at low .nice(l) 

nl; line numbering filter.nl(l) 

list, nlist; get entries from name .nlist(3C) 

nm; print name list.nm(l) 

hangups and quits, nohup; run a command immune to.nohup(l) 

setjmp, longjmp; non-local goto.setjmp(3C) 

format mathematical text for nroff or troff./checkeq;.eqn(l) 

tbl; format tables for nroff or troff.tbl(l) 

troff, nroff: typeset or format text.troff(l) 

constructs, deroff; remove nroff/troff, tbl, and eqn .deroff(l) 

null: the null file.null(4) 

null: the null file.null(4) 

factor, primes; factor a number, generate large primes.factor(l) 

nl; line numbering filter.nl(l) 

graphics: access graphical and numerical commands.graphics(lG) 

size; size of an object file.size(l) 

find ordering relation for an object library, lorder;.lorder(l) 

sky; obtain ephemerides.sky(6) 

od; octal dump.od(l) 

od: octal dump.od(l) 

daemons, line printer/dpd, odpd, Ipd: HONEYWELL sending .dpd(lC) 

dpr; off-line print.dpr(lC) 

fopen, freopen, fdopen: open a stream.fopen(3S) 

dup: duplicate an open file descriptor.dup(2) 

open: open for reading or writing.open(2) 

writing, open: open for reading or .open(2) 

prf; operating system profiler.prf(4) 

/prfdc, prfsnap, prfpr: operating system profiler.profiler(lM) 

strcspn, strtok; string operations, /strpbrk, strspn.string(3C) 

vaxops: VAX-11/780 console operations.vaxops(8) 

join; relational database operator.join(l) 

getopt: get option letter from argv.getopt(3C) 

fcntl: file control options.fcntl(7) 

stty:setthe options for a terminal..stty(l) 

getopt; parse command options.getopt(l) 

object library, lorder: find ordering relation for an.lorder(l) 

a directory, or a special or ordinary file, mknod: make .mknod(2) 

assembler and link editor output, a.out:.a.out(5) 

ecvt, fcvt: output conversion.ecvt(3C) 

printf, fprintf, sprintf: output formatters.printf(3S) 

gcat: send phototypesetter output to the HONEYWELL 6000.gcat(lC) 

miscellaneous/acct: overview of accounting and .acct(lM) 

chown: change owner and group of a file.chown(2) 

chown, chgrp: change owner or group.chown(l) 

and expand files, pack, peat, unpack; compress.pack(l) 

etp; Equipment Test Package.etp(8) 

documents, mm: the MM macro package for formatting .mm(7) 

graphs, mv: a macro package for making view .mv(7) 

sar; system activity report package.sar(8) 

standard buffered input/output package, stdio: .stdio(3S) 

format and/or check RP06 disk packs. rp6fmt: .rp6fmt(8) 

4014 terminal. 4014: paginator for the Tektronix.4014(1) 

interface, pci: parallel communications link.pcl(4) 

process, process group, and parent process IDs./get.getpid(2) 

getopt; parse command options.getopt(l) 

passwd: change login password.passwd(l) 

passwd: password file.passwd(5) 

/setpwent, endpwent: get password file entry.getpwent(3C) 
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putpwent: write password file entry.putpwent(3C) 

passwd; password file.passwd(5) 

getpass: read a password.getpass(3C) 

passwd: change login password.passwd(l) 

pwck, grpck: password/group file checkers.pwck(lM) 

several files or subsequent/ paste: merge same lines of.paste(l) 

dimame: deliver portions of path names, basename,.basename(l) 

fgrep: search a file for a pattern, grep, egrep.grep(l) 

processing language, awk: pattern scanning and.awk(l) 

signal, pause: suspend process until.pause(2) 

expand files, pack, peat, unpack: compress and .pack(l) 

cc, pcc: C compiler.cc(l) 

link interface, pci: parallel communications.pcl(4) 

process, popen, pclose: initiate I/O to/from a.popen(3S) 

fsev: convert files between PDP-11 and VAX-11/780 systems.fscv(lM) 

as: assembler for PDP-11.as.pdp(l) 

/convert archive files from PDP-11 to VAX-11/780 format.arcv(l) 

mesg: permit or deny messages.mesg(l) 

ptx: permuted index.ptx(l) 

format, acet: per-process accounting file.acct(5) 

acetems: command summary from per-process accounting/.acctcms(lM) 

ermo: system error messages, perror, sys_errlist, sys_nerr, .perror(3C) 

cat: phototypesetter interface.cat(4) 

HONEYWELL 6000. gcat: send phototypesetter output to the.gcat(lC) 

tc: phototypesetter simulator.tc(l) 

split: split a file into pieces.split(l) 

channel, pipe: create an interprocess.pipe(2) 

tee: pipe fitting.tee(l) 

plot: graphics interface.plot(5) 

subroutines, plot: graphics interface .plot(3X) 

images, pnch: file format for card .pnch(5) 

Iseek: move read/write file pointer.lseek(2) 

to/from a process, popen, pclose: initiate I/O.popen(3S) 

basename, dimame: deliver portions of path names.basename(l) 

banner: make posters.banner(l) 

logarithm, power,/ exp, log, pow, sqrt: exponential, .exp(3M) 

/sqrt: exponential, logarithm, power, square root functions.exp(3M) 

pr: print files.pifl) 

fortroff. cw, checkew: prepare constant-width text .cw(l) 

monitor: prepare execution profile.monitor(3C) 

unget: undo a previous get of an SCCS file.unget(l) 

profiler, prf: operating system.prf(4) 

operating/prfld, prfstat, prfdc, prfsnap, prfpr:.profiler(lM) 

prfsnap, prfpr: operating/ prfld, prfstat, prfdc,.profiler(lM) 

/prfstat, prfdc, prfsnap, prfpr: operating system/.profiler(lM) 

system/prfld, prfstat, prfdc, prfsnap, prfpr: operating.profiler(lM) 

prfpr: operating/prfld, prfstat, prfdc, prfsnap.profiler(lM) 

generate large/factor, primes: factor a number,.factor(l) 

a number, generate large primes./primes: factor .factor(l) 

graphical/ gps: graphical primitive string, format of.gps(5) 

types: primitive system data types.types(7) 

prs: print an SCCS file.prs(l) 

date: print and set the date..date(l) 

cal: print calendar.cal(l) 

editing activity, sact: print current SCCS file .sact(l) 

dpr: off-line print. .dpr(lC) 

man: print entries in this manual.man(l) 

cat: concatenate and print files.cat(l) 

pr: print files.pifl) 

nm: print name list.nm(l) 

uname: print name of current UNIX.uname(l) 

news: print news items..news(l) 

with the MM macros, mm: print out documents formatted .mm(l) 

file(s). acctcom: search and print process accounting.acctcom(l) 

names, id: print user and group IDs and.id(l) 

vpmtrace: load the KMCl 1-B; print VPM traces./vpmsnap.vpmstart(lC) 

sending daemons, line printer daemon. /HONEYWELL.dpd(lC) 

Ip: line printer.lp(4) 

Ipr: line printer spooler. .Ipr(l) 

vpr: Versatec printer spooler. .vpr(l) 

vp: Versatec printer.vp(4) 

output formatters, printf, fprintf, sprintf:.printf(3S) 
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nice; run a command at low priority.nice(l) 

nice; change priority of a process.nice(2) 

errors, errpt; process a report of logged.errpt(lM) 

acct; enable or disable process accounting.acct(2) 

acctprc; process accounting.acctprc(lM) 

acctcom; search and print process accounting file(s).acctcom(l) 

times, times: get process and child process .times(2) 

initialization, init: process control .init(8) 

exit: terminate process.exit(2) 

fork; create a new process.fork(2) 

/getpgrp, getppid; get process, process group, and parent/.getpid(2) 

setpgrp: set process group ID.setpgrp(2) 

process group, and parent process IDs./get process.getpid(2) 

kill; terminate a process.kill(l) 

nice: change priority of a process.nice(2) 

kill; send a signal to a process or a group of/.kill(2) 

pclose: initiate I/O to/from a process, popen.popen(3S) 

getpid, getpgrp, getppid: get process, process group, and/.getpid(2) 

ps: report process status.ps(l) 

times: get process and child process times.times(2) 

wait; wait for child process to stop or terminate.wait(2) 

ptrace: process trace.ptrace(2) 

pause: suspend process until signal.pause(2) 

wait; await completion of process.wait(l) 

list of file systems processed by fsck. checklist:.checklist(5) 

to a process or a group of processes./send a signal .kill(2) 

awk: pattern scanning and processing language.awk(l) 

shutdown; terminate all processing.shutdown(lM) 

m4: macro processor.m4(l) 

alarm: set a process’s alarm clock.alarm(2) 

prof: display profile data.prof(l) 

profile, profil: execution time.profil(2) 

prof: display profile data..prof(l) 

monitor; prepare execution profile.monitor(3C) 

profil: execution time profile.profil(2) 

environment at login time, profile; setting up an.profile(5) 

prf: operating system profiler.prf(4) 

prfpr: operating system profiler./prfdc, prfsnap,.profiler(lM) 

shell, the standard command programming language, sh: .sh(l) 

link with built-in DDCMP protocol, dmc: communications.dmc(4) 

vpm: The Virtual Protocol Machine.vpm(4) 

vpmc: compiler for the virtual protocol machine.vpmc(lC) 

arithmetic; provide drill in number facts.arithmetic(6) 

true, false: provide truth values.true(l) 

prs: print an SCCS file.prs(l) 

ps; report process status.ps(l) 

ptrace: process trace.ptrace(2) 

ptx; permuted index.ptx(l) 

stream, ungetc: push character back into input .ungetc(3S) 

put character or word on a/ putc, putchar, fputc, putw:.putc(3S) 

character or word on a/putc, putchar, fputc, putw: put.putc(3S) 

entry, putpwent; write password file.putpwent(3C) 

stream, puts, fputs: put a string on a .puts(3S) 

a/putc, putchar, fputc, putw; put character or word on.putc(3S) 

file checkers, pwck, grpck: password/group.pwck(lM) 

pwd: working directory name.pwd(l) 

qsort; quicker sort.qsort(3C) 

qsort; quicker sort.qsort(3C) 

command immune to hangups and quits, nohup; run a.nohup(l) 

quiz: test your knowledge.quiz(6) 

generator, rand, srand: random number.rand(3C) 

rand, srand: random number generator.rand(3C) 

dialect, ratfor: rational Fortran .ratfor(l) 

ratfor: rational Fortran dialect.ratfor(l) 

shell script, rc: system initialization.rc(8) 

getpass: read a password.getpass(3C) 

read: read from file.read(2) 

rmail; send mail to users or read mail, mail,.mail(l) 

line; read one line.line(l) 

read: read from file.read(2) 

open: open for reading or writing.open(2) 

Iseek; move read/write file pointer.lseek(2) 
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allocator, malloc, free, realloc, calloc: main memory.malloc(3C) 

specify what to do upon receipt of a signal, signal;.signal(2) 

from per-process accounting records./command summary.acctcms(lM) 

errdead: extract error records from dump.errdead(lM) 

wtmpfix: manipulate wtmp records, fwtmp.fwtmp(lM) 

xref: cross reference for C programs.xref(l) 

reform; reformat text file.reform(l) 

reform; reformat text file.reform(l) 

compile, regcmp; regular expression.regcmp(l) 

compile/execute, regex, regcmp; regular expression.regex(3X) 

make; maintain, update, and regenerate groups of programs.make(l) 

expression compile/execute, regex, regcmp: regular .regex(3X) 

compile and match routines, regexp: regular expression.regexp(7) 

match routines, regexp: regular expression compile and.regexp(7) 

regcmp: regular expression compile.regcmp(l) 

regex, regcmp: regular expression/.regex(3X) 

sorted files, comm: select or reject lines common to two.comm(l) 

lorder: find ordering relation for an object/.lorder(l) 

join; relational database operator.join( 1) 

strip: remove symbols and relocation bits. .strip(l) 

value, floor, ceiling, remainder functions, /absolute .floor(3M) 

commands, mk: how to remake the system and .mk(8) 

calendar: reminder service.calendar(l) 

hasp: RJE (Remote Job Entry) to IBM.hasp(8) 

rje; RJE (Remote Job Entry) to IBM.ije(8) 

uvac; RJE (Remote Job Entry) to UNIVAC.uvac(8) 

file, rmdel: remove a delta from an SCCS .rmdel(l) 

unlink; remove directory entry.unlink(2) 

rm, rmdir: remove files or directories.rm(l) 

eqn constructs, deroff: remove nroff/troff, tbl, and.deroff(l) 

bits, strip: remove symbols and relocation.strip(l) 

check and interactive repair./system consistency .fsck(lM) 

uniq: report repeated lines in a file.uniq(l) 

console, rjestat: RJE status report and interactive status .ijestat(lC) 

blocks, df: report number of free disk.df(l) 

errpt: process a report of logged errors.errpt(lM) 

sar: system activity report package. .sar(8) 

ps; report process status.ps(l) 

file, uniq: report repeated lines in a.uniq(l) 

and generate a system activity report, timex; time a command.timex(l) 

fseek, ftell, rewind: reposition a stream.fseek(3S) 

system restore, restor; incremental file .restor(lM) 

incremental file system restore, restor: .restor(lM) 

interpreter), rsh: restricted shell (command.rsh(l) 

fget.demon, fget.odemon: file retrieval daemons.fget.demon(lC) 

HONEYWELL 6000. fget: retrieve files from the.fget(lC) 

stat: data returned by stat system call.stat(7) 

reversi; a game of dramatic reversals.reversi(6) 

col; filter reverse line-feeds.col(l) 

reversals, reversi; a game of dramatic .reversi(6) 

fseek, ftell, rewind; reposition a stream.fseek(3S) 

creat; create a new file or rewrite an existing one.creat(2) 

file, if: RFll/RS 11 fixed-head disk.rf(4) 

file, rf: RFll/RS 11 fixed-head disk .rf(4) 

disk file, hs: RH11/RJS03-RJS04 fixed-head.hs(4) 

gather files and/or submit RJE jobs, send, gath;.send(lC) 

hasp; RJE (Remote Job Entry) to IBM.hasp(8) 

ije: RJE (Remote Job Entry) to IBM.ije(8) 

UNIV AC. uvac: RJE (Remote Job Entry) to.uvac(8) 

IBM. ije; RJE (Remote Job Entry) to.ije(8) 

rjestat: RJE status and enquiries.orjestat(lC) 

interactive status/rjestat: RJE status report and.ijestat(lC) 

enquiries, rjestat: RJE status and.orjestat(lC) 

interactive status console, rjestat: RJE status report and.ijestat(lC) 

rk:RK-ll/RK03orRK05disk.rk(4) 

rk:RK-ll/RK03or RK05 disk.rk(4) 

rk; RK-ll/RK03orRK05disk.rk(4) 

rl:RL-ll/RL01disk.rl(4) 

rl: RL-ll/RLOl disk.rl(4) 

directories, rm, rmdir: remove files or.rm(l) 

read mail, mail, rmail; send mail to users or .mail(l) 

SCCS file, rmdel; remove a delta from an .rmdel(l) 
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directories, rm, rmdir: remove files or.rm(l) 

romboot: special ROM bootstrap loaders.romboot(8) 

loaders, romboot; special ROM bootstrap .romboot(8) 

chroot; change root directory.chroot(2) 

chroot: change root directory for a command.chroot(lM) 

logarithm, power, square root functions, /exponential,.exp(3M) 

/tekset, td: graphical device routines and filters.gdev(lG) 

expression compile and match routines, regexp: regular .regexp(7) 

graphical table of contents routines, toe:.toc(lG) 

disk, rp; RP-11/RP03 moving-head .rp(4) 

moving-head disk, hp: RP04/RP05/RP06.hp(4) 

rp6fmt: format and/or check RP06 disk packs.rp6fmt(8) 

rp; RP-11/RP03 moving-head disk.rp(4) 

RP06 disk packs. rp6fmt: format and/or check.rp6fmt(8) 

interpreter), rsh: restricted shell (command .rsh(l) 

nice: run a command at low priority.nice(l) 

hangups and quits, nohup: run a command immune to.nohup(l) 

runacct: run daily accounting.runacct(lM) 

runacct; run daily accounting.runacct(lM) 

editing activity, sact; print current SCCS file.sact(l) 

sag; system activity graph.sag(lM) 

package, sar; system activity report.sar(8) 

space allocation, brk, sbrk: change data segment.brk(2) 

formatted input conversion, scanf, fscanf, sscanf: .scanf(3S) 

bfs: big file scanner.bfs(l) 

language, awk; pattern scanning and processing.awk(l) 

stand-alone programs, see: C compiler for.scc(l) 

the delta commentary of an SCCS delta, ede; change .cdc(l) 

comb: combine SCCS deltas.comb(l) 

make a delta (change) to an SCCS file, delta; .delta(l) 

sact: print current SCCS file editing activity.sact(l) 

get: get a version of an SCCS file.get(l) 

prs: print an SCCS file.prs(l) 

rmdel: remove a delta from an SCCS file.rmdel(l) 

compare two versions of an SCCS file, scesdiff; .sccsdiff(l) 

scesfile; format of SCCS file.sccsfile(5) 

undo a previous get of an SCCS file, unget: .unget(l) 

val: validate SCCS file. .val(l) 

admin: create and administer SCCS files.admin(l) 

what: identify SCCS files.what(l) 

of an SCCS file, scesdiff; compare two versions.sccsdiff(l) 

scesfile; format of SCCS file.sccsfile(5) 

system initialization shell script, rc; .rc(8) 

sdb: symbolic debugger.sdb(l) 

program, sdiff: side-by-side difference.sdiff(l) 

grep, egrep, fgrep: search a file for a pattern.grep(l) 

accounting file(s). acctcom: search and print process.acctcom(l) 

Isearch: linear search and update.lsearch(3C) 

bsearch; binary search.bsearch(3C) 

sed: stream editor.sed(l) 

brk, sbrk; change data segment space allocation.brk(2) 

to two sorted files, comm: select or reject lines common.comm(l) 

greek; select terminal filter.greek(l) 

of a file, cut: cut out selected fields of each line.cut(l) 

a group of processes, kill: send a signal to a process or .kill(2) 

6000. fsend: send files to the HONEYWELL.fsend(lC) 

and/or submit RJE jobs, send, gath; gather files .send(lC) 

gcosmail: send mail to HIS user.gcosmail(lC) 

mail, mail, rmail: send mail to users or read .mail(l) 

the HONEYWELL 6000. gcat: send phototypesetter output to .gcat(lC) 

dpd, odpd, Ipd: HONEYWELL sending daemons, line printer/ .dpd(lC) 

stream, setbuf; assign buffering to a .setbuf(3S) 

IDs. setuid, setgid: set user and group .setuid(2) 

getgrent, getgrgid, getgrnam, setgrent, endgrent: get group/.getgrent(3C) 

goto, setjmp, longjmp; non-local.setjmp(3C) 

encryption, crypt, setkey, encrypt: DES.crypt(3C) 

table, setmnt: establish mnttab.setmnt(lM) 

setpgrp; set process group ID.setpgrp(2) 

getpwent, getpwuid, getpwnam, setpwent, endpwent: get/ .getpwent(3C) 

login time, profile: setting up an environment at.profile(5) 

group IDs. setuid, setgid: set user and.setuid(2) 

command programming language, sh: shell, the standard.sh(l) 
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rsh: restricted shell (command interpreter).rsh(l) 

system: issue a shell command.system(3S) 

accounting, acctsh: shell procedures for .acctsh(lM) 

rc: system initialization shell script..rc(8) 

programming language, sh: shell, the standard command.sh(l) 

processing, shutdown: terminate all.shutdown(lM) 

program, sdiff: side-by-side difference .sdiff(l) 

login: sign on.login(l) 

pause: suspend process until signal.pause(2) 

what to do upon receipt of a signal, signal: specify.signal(2) 

upon receipt of a signal, signal: specify what to do .signal(2) 

of processes, kill: send a signal to a process or a group.kill(2) 

ssignal, gsignal: software signals.ssignal(3C) 

lex: generate programs for simple lexical tasks.lex(l) 

tc: phototypesetter simulator.tc(l) 

atan, atan2: trigonometric/ sin, cos, tan, asin, acos.trig(3M) 

functions, sinh, cosh, tanh: hyperbolic .sinh(3M) 

size: size of an object file.size(l) 

size: size of an object file.size(l) 

sky: obtain ephemerides.sky(6) 

an interval, sleep: suspend execution for.sleep(l) 

interval, sleep: suspend execution for.sleep(3C) 

documents, view graphs, and slides, mmt, mvt: typeset .mmt(l) 

spline: interpolate smooth curve.spline(lG) 

sno: SNOBOL interpreter.sno(l) 

sno: SNOBOL interpreter.sno(l) 

ssignal, gsignal: software signals.ssignal(3C) 

sort: sort and/or merge files.sort(l) 

qsort: quicker sort.qsort(3C) 

sort: sort and/or merge files.sort(l) 

tsort: topological sort.tsort(l) 

or reject lines common to two sorted files, comm: select.comm(l) 

brk, sbrk: change data segment space allocation..brk(2) 

fspec: format specification in text files.fspec(5) 

receipt of a signal, signal: specify what to do upon.signal(2) 

spelling errors, spell, spellin, spellout: find.spell(l) 

spelling errors, spell, spellin, spellout: find.spell(l) 

spell, spellin, spellout: find spelling errors.spell(l) 

errors, spell, spellin, spellout: find spelling.spell(l) 

curve, spline: interpolate smooth.spline(lG) 

split: split a file into pieces..split(l) 

csplit: context split.csplit(l) 

exponent, frexp, Idexp, modf: split into mantissa and .frexp(3C) 

pieces, split: split a file into .split(l) 

uuclean: uucp spool directory clean-up.uuclean(lM) 

Ipr: line printer spooler.Ipr(l) 

vpr: Versatec printer spooler.vpr(l) 

prinlf, fprintf, sprintf: output formatters.printf(3S) 

power, square/ exp, log, pow, sqrt: exponential, logarithm.exp(3M) 

exponential, logarithm, power, square root functions, /sqrt: .exp(3M) 

generator, rand, srand: random number .rand(3C) 

conversion, scanf, fscanf, sscanf: formatted input .scanf(3S) 

signals, ssignal, gsignal: software .ssignal(3C) 

control. St: synchronous terminal.st(lM) 

interface, st: synchronous terminal.st(4) 

see: C compiler for stand-alone programs..scc(l) 

package, stdio: standard buffered input/output .stdio(3S) 

language, sh: shell, the standard command programming .sh(l) 

unixboot: UNIX startup and boot procedures.unixboot(8) 

system call, stat: data returned by stat .stat(7) 

stat, fstat: get file status.stat(2) 

useful with graphical/ stat: statistical network .stat(lG) 

stat: data returned by stat system call..stat(7) 

with graphical/stat: statistical network useful .stat(lG) 

ustat: get file system statistics.ustat(2) 

rjestat: RJE status and enquiries.orjestat(lC) 

status report and interactive status console, ijestat: RJE.ijestat(lC) 

feof, clearerr, fileno: stream status inquiries, ferror.ferror(3S) 

control, uustat: uucp status inquiry and job.uustat(lC) 

ps: report process status.ps(l) 

status console, rjestat: RJE status report and interactive .ijestat(lC) 

stat, fstat: get file status.stat(2) 
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input/output package, stdio: standard buffered.stdio(3S) 

stime; set time.stime(2) 

wait for child process to stop or terminate, wait:.wait(2) 

stmcmp, strcpy, stmcpy,/ strcat, stmcat, strcmp,.string(3C) 

/strcpy, stmcpy, strlen, strchr, strrchr, strpbrk,/ .string(3C) 

stmcpy,/ strcat, stmcat, strcmp, stmcmp, strcpy,.string(3C) 

/stmcat, strcmp, stmcmp, strcpy, stmcpy, strlen,/ .string(3C) 

/strrchr, strpbrk, strspn, strcspn, strtok: string/.string(3C) 

sed: stream editor.sed(l) 

fflush: close or flush a stream, fclose.fcIose(3S) 

fopen, freopen, fdopen: open a stream.fopen(3S) 

ftell, rewind: reposition a stream, fseek,.fseek(3S) 

get character or word from stream, /getchar, fgetc, getw:.getc(3S) 

fgets: get a string from a stream, gets.gets(3S) 

put character or word on a stream./putchar, fputc, putw: .putc(3S) 

puts, fputs: put a string on a stream.puts(3S) 

setbuf: assign buffering to a stream.setbuf(3S) 

/feof, clearerr, fileno: stream status inquiries.ferror(3S) 

push character back into input stream, ungetc: .ungetc(3S) 

gps: graphical primitive string, format of graphical/.gps(5) 

gets, fgets: get a string from a stream.gets(3S) 

puts, fputs: put a string on a stream.puts(3S) 

strspn, strcspn, strtok: string operations, /strpbrk,.string(3C) 

relocation bits, strip: remove symbols and.strip(l) 

/stmcmp, strcpy, stmcpy, strlen, strchr, strrchr,/.string(3C) 

strcpy, stmcpy,/ strcat, stmcat, strcmp, stmcmp,.string(3C) 

strcat, stmcat, strcmp, stmcmp, strcpy, stmcpy,/ .string(3C) 

/strcmp, stmcmp, strcpy, stmcpy, strlen, strchr,/ .string(3C) 

/strlen, strchr, strrchr, strpbrk, strspn, strcspn,/.string(3C) 

/stmcpy, strlen, strchr, strrchr, strpbrk, strspn,/.string(3C) 

/strchr, strrchr, strpbrk, strspn, strcspn, strtok:/ .string(3C) 

/strpbrk, strspn, strcspn, strtok: string operations.string(3C) 

terminal, stty: set the options for a.stty(l) 

another user, su: become super-user or .su(l) 

gath: gather files and/or submit RJE jobs, send,.send(lC) 

intro: introduction to subroutines and libraries.mtro(3) 

plot: graphics interface subroutines.plot(3X) 

/same lines of several files or subsequent lines of one file.paste(l) 

file, sum: sum and count blocks in a.sum(l) 

file, sum: sum and count blocks in a.sum(l) 

du: summarize disk usage.du(l) 

accounting/acctcms: command summary from per-process.acctcms(lM) 

sync: update the super block.sync(lM) 

sync: update super-block.sync(2) 

su: become super-user or another user.su(l) 

interval, sleep: suspend execution for an .sleep(l) 

interval, sleep: suspend execution for.sleep(3C) 

pause: suspend process until signal.pause(2) 

swab: swap bytes.swab(3C) 

swab: swap bytes.swab(3C) 

sdb: symbolic debugger. .sdb(l) 

strip: remove symbols and relocation bits.strip(l) 

sync: update super-block.sync(2) 

sync: update the super block.sync(lM) 

du: DU-11 synchronous line interface.du(4) 

st: synchronous terminal control.st(lM) 

interface, st: synchronous terminal.st(4) 

sysdef: system definition.sysdef(lM) 

system error/perror, sys_errlist, sys_nerr, ermo:.perror(3C) 

perror, sys_errlist, sys_nerr, ermo: system error/.perror(3C) 

master device information table, master:.master(5) 

mnttab: mounted file system table.mnttab(5) 

toe: graphical table of contents routines.toc(lG) 

setmnt: establish mnttab table.setmnt(lM) 

tbl: format tables for nroff or troff..tbl(l) 

tabs: set tabs on a terminal.tabs(l) 

tabs: set tabs on a terminal.tabs(l) 

a file, tail: deliver the last part of.tail(l) 

trigonometric/ sin, cos, tan, asin, acos, atan, atan2:.trig(3M) 

sinh, cosh, tanh: hyperbolic functions.sinh(3M) 

tp: manipulate tape archive.tp(l) 

tapeboot: magnetic tape bootstrap program.tapeboot(8) 
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tar: tape file archiver.tar(l) 

dump: incremental dump tape format..dump(5) 

tp: magnetic tape format..tp(5) 

ht: TUI 6 magnetic tape interface.ht(4) 

tm: TMl 1/TUlO magnetic tape interface.tm(4) 

bootstrap program, tapeboot: magnetic tape.tapeboot(8) 

file system backup, filesave, tapesave: daily/weekly UNIX.filesave(8) 

tar: tape file archiver.tar(l) 

programs for simple lexical tasks, lex: generate.lex(l) 

deroff: remove nroff/troff, tbl, and eqn constructs.derofffl) 

ortroff. tbl: format tables for nroff.tbl(l) 

tc: phototypesetter simulator.tc(l) 

hpd, erase, hardcopy, tekset, td: graphical device routines/.gdev(lG) 

tee: pipe fitting..tee(l) 

hpd, erase, hardcopy, tekset, td: graphical device/ .gdev(lG) 

4014: paginator for the Tektronix 4014 terminal.4014(1) 

tmpfile: create a temporary file. .tmpfile(3S) 

tmpnam: create a name for a temporary file. .tmpnam(3S) 

term: conventional names.term(7) 

for the Tektronix 4014 terminal. 4014: paginator.4014(1) 

functions of the DASI450 terminal. 450: handle special. 450(1) 

St: synchronous terminal control..st(lM) 

ct: call terminal.ct(lC) 

generate file name for terminal, ctermid: .ctermid(3S) 

greek: select terminal filter.greek(l) 

getty: set the modes of a terminal.getty(8) 

St: synchronous terminal interface.st(4) 

tty: general terminal interface.tty(4) 

stty: set the options for a terminal.stty(l) 

tabs: set tabs on a terminal.tabs(l) 

isatty: find name of a terminal, ttyname,.ttyname(3C) 

functions of DASI 300 and 300s terminals./handle special. 300(1) 

of HP 2640 and 2621-series terminals./special functions.hp(l) 

tty: get the terminal’s name.tty(l) 

kill: terminate a process.kill(l) 

shutdown: terminate all processing.shutdown(lM) 

exit: terminate process.exit(2) 

daemon, errstop: terminate the error-logging.errstop(lM) 

for child process to stop or terminate, wait: wait.wait(2) 

command, test: condition evaluation .test(l) 

etp: Equipment Test Package.etp(8) 

quiz: test your knowledge.quiz(6) 

ed: text editor.ed(l) 

reform: reformat text file.reform(l) 

fspec: format specification in text files.fspec(5) 

/checkeq: format mathematical text for nroff or troff..eqn(l) 

prepare constant-width text for troff. cw, checkcw: .cw(l) 

nroff: typeset or format text, troff, .troff(l) 

ttt, cubic: tic-tac-toe. .ttt(6) 

system activity/timex: time a command and generate a.timex(l) 

time: time a command.time(l) 

time: get time.time(2) 

profil: execution time profile.profil(2) 

up an environment at login time, profile: setting.profile(5) 

stime: set time.stime(2) 

time: time a command.time(l) 

time: get time.time(2) 

tzset: convert date and time to ASCII, /asctime.ctime(3C) 

process times, times: get process and child .times(2) 

update access and modification times of a file, touch:.touch(l) 

get process and child process times, times: .times(2) 

file access and modification times, utime: set.utime(2) 

generate a system activity/ timex: time a command and .timex(l) 

interface, tm: TMl 1/TUlO magnetic tape.tm(4) 

interface, tm: TMl 1/TU10 magnetic tape .tm(4) 

file, tmpfile: create a temporary.tmpfile(3S) 

temporary file, tmpnam: create a name for a.tmpnam(3S) 

toupper, tolower, toascii: character/ .conv(3C) 

contents routines, toe: graphical table of.toc(lG) 

popen, pclose: initiate I/O to/from a process.popen(3S) 

translation, toupper, tolower, toascii: character.conv(3C) 

tsort: topological sort.tsort(l) 
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acctmerg: merge or add total accounting files.acctmerg(lM) 

modification times of a file, touch; update access and .touch(l) 

character translation, toupper, tolower, toascii; .conv(3C) 

tp: magnetic tape format.tp(5) 

tp; manipulate tape archive.tp(l) 

tplot: graphics filters.tplot(lG) 

tr: translate characters.tr(l) 

trace: event-tracing driver.trace(4) 

ptrace: process trace.ptrace(2) 

load the KMCl 1-B; print VPM traces./vpmsnap, vpmtrace:.vpmstart(lC) 

tr: translate characters. .tr(l) 

tolower, toascii: character translation, toupper, .conv(3C) 

tan, asin, acos, atan, atan2: trigonometric functions, /cos.trig(3M) 

constant-width text for troff. cw, checkcw: prepare .cw(l) 

mathematical text for nroff or troff./neqn, checkeq; format.eqn(l) 

format text, troff, nroff: typeset or.troff(l) 

format tables for nroff or troff. tbl:.tbl(l) 

values, true, false: provide truth.true(l) 

true, false: provide truth values.true(l) 

tsort: topological sort.tsort(l) 

ttt, cubic: tic-tac-toe.ttt(6) 

interface, tty: general terminal .tty(4) 

tty: get the terminal ’ s name.tty( 1) 

graphics for the extended TTY-37 type-box. greek: .greek(7) 

a terminal, ttyname, isatty: find name of.ttyname(3C) 

ht; TUI6 magnetic tape interface.ht(4) 

dqs: DQS-11 interface for two-point BSC.dqs(4) 

file; determine file type.file(l) 

for the extended TTY-37 type-box. greek: graphics.greek(7) 

types, types; primitive system data .types(7) 

types; primitive system data types.types(7) 

graphs, and slides, mmt, mvt: typeset documents, view.mmt(l) 

troff, nroff: typeset or format text.troff(l) 

typographical errors, typo: find possible.typo(l) 

typo: find possible typographical errors.typo(l) 

/localtime, gmtime, asctime, tzset: convert date and time/.ctime(3C) 

getpw; get name from UID. .getpw(3C) 

limits, ulimit: get and set user .ulimit(2) 

creation mask, umask: set and get file .umask(2) 

mask, umask; set file-creation mode.umask(l) 

file system, mount, umount: mount and dismount.mount(lM) 

umount; unmount a file system.umount(2) 

UNIX system, uname; get name of current .uname(2) 

UNIX, uname; print name of current.uname(l) 

KMCll/DMCll/kun: un-assembler for the .kun(l) 

file, unget: undo a previous get of an SCCS.unget(l) 

an sees file, unget; undo a previous get of.unget(l) 

into input stream, ungetc; push character back .ungetc(3S) 

a file, uniq: report repeated lines in.uniq(l) 

mktemp:makea unique file name.mktemp(3C) 

units: conversion program.units(l) 

RJE (Remote Job Entry) to UNIVAC. uvac:.uvac(8) 

boot procedures, unixboot: UNIX startup and.unixboot(8) 

uuto, uupick: public UNIX-to-UNIX file copy.uuto(lC) 

unlink system calls, link, unlink; exercise link and.link(lM) 

entry, unlink; remove directory .unlink(2) 

unlink; exercise link and unlink system calls, link, .link(lM) 

umount; unmount a file system.umount(2) 

files, pack, peat, unpack: compress and expand .pack(l) 

times of a file, touch: update access and modification.touch(l) 

of programs, make; maintain, update, and regenerate groups .make(l) 

Isearch: linear search and update.lsearch(3C) 

sync; update super-block.sync(2) 

sync; update the super block.sync(lM) 

du: summarize disk usage.du(l) 

delimiters, mmchek: check usage of mm macros and eqn.mmchek(l) 

stat: statistical network useful with graphical/.stat(lG) 

id; print user and group IDs and names.id(l) 

setuid, setgid: set user and group IDs. .setuid(2) 

character login name of the user, cuserid:.cuserid(3S) 

/getgid, getegid; get real user, effective user, real/.getuid(2) 

environ; user environment.environ(7) 
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gcosraail: send mail to HIS user. .gcosmail(lC) 

ulimit: get and set user limits..ulimit(2) 

logname: login name of user. .logname(3X) 

/get real user, effective user, real group, and/.getuid(2) 

become super-user or another user.su:.su(l) 

write: write to another user. .write(l) 

mail, rmail: send mail to users or read mail.mail(l) 

wall: write to all users..wall(lM) 

statistics, ustat: get file system .ustat(2) 

gutil: graphical utilities.gutil(lG) 

modification times, utime: set file access and .utime(2) 

utmp, wtmp: utmp and wtmp entry format.utmp(5) 

entry format, utmp, wtmp: utmp and wtmp.utmp(5) 

clean-up. uuclean: uucp spool directory.uuclean(lM) 

uusub: monitor uucp network.uusub(lM) 

uuclean: uucp spool directory clean-up.uuclean(lM) 

control, uustat: uucp status inquiry and job.uustat(lC) 

Unix copy, uucp, uulog, uuname: unix to.uucp(lC) 

copy, uucp, uulog, uuname: unix to unix.uucp(lC) 

uucp, uulog, uuname: unix to unix copy.uucp(lC) 

file copy, uuto, uupick: public UNIX-to-UNIX.uuto(lC) 

and job control, uustat: uucp status inquiry.uustat(lC) 

uusub: monitor uucp network.uusub(lM) 

UNIX-to-UNIX file copy, uuto, uupick: public .uuto(lC) 

execution, uux: unix to unix command .uux(lC) 

to UNIVAC. uvac: RJE (Remote Job Entry) .uvac(8) 

val: validate SCCS file.val(l) 

val: validate SCCS file.val(l) 

abs: integer absolute value.abs(3C) 

fabs, ceil, fmod: absolute value, floor, ceiling,/ floor,.floor(3M) 

getenv: value for environment name.getenv(3C) 

true, false: provide truth values..true(l) 

as: assembler for VAX-11/780.as.vax(l) 

vaxops: VAX-11/780 console operations.vaxops(8) 

archive files from PDP-11 to VAX-11/780 format, /convert .arcv(l) 

interface, vlx: VAX-11/780 LSI console floppy .vlx(lM) 

files between PDP-11 and VAX-11/780 systems./convert.fscv(lM) 

operations, vaxops: VAX-11/780 console .vaxops(8) 

vc: version control.vc(l) 

assert: program verification.assert(3X) 

vpr: Versatec printer spooler.vpr(l) 

vp: Versatec printer.vp(4) 

vc: version control.vc(l) 

get: get a version of an SCCS file.get(l) 

sccsdiff: compare two versions of an SCCS file.sccsdiff(l) 

mmt, mvt: typeset documents, view graphs, and slides.mmt(l) 

mv: a macro package for making view graphs.mv(7) 

vpm: The Virtual Protocol Machine.vpm(4) 

vpmc: compiler for the virtual protocol machine.vpmc(lC) 

floppy interface, vlx: VAX-11/780 LSI console .vlx(lM) 

systems with label checking, volcopy, labeht: copy file .volcopy(lM) 

file system: format of system volume.fs(5) 

vp: Versatec printer.vp(4) 

Machine, vpm: The Virtual Protocol.vpm(4) 

load the KMCl 1-B; print VPM traces./vpmtrace:.vpmstart(lC) 

protocol machine, vpmc: compiler for the virtual .vpmc(lC) 

KMCl 1-B; print VPM/vpmstart, vpmsnap, vpmtrace: load the.vpmstart(lC) 

load the KMCl 1-B; print VPM/ vpmstart, vpmsnap, vpmtrace: .vpmstart(lC) 

print VPM/vpmstart, vpmsnap, vpmtrace: load the KMCl 1-B; .vpmstart(lC) 

vpr: Versatec printer spooler.vpr(l) 

process, wait: await completion of.wait(l) 

or terminate, wait: wait for child process to stop.wait(2) 

to stop or terminate, wait: wait for child process.wait(2) 

wall: write to all users.wall(lM) 

wc: word count.wc(l) 

what: identify SCCS files.what(l) 

signal, signal: specify what to do upon receipt of a .signal(2) 

crashes, crash: what to do when the system .crash(8) 

whodo: who is doing what.whodo(lM) 

who: who is on the system..who(l) 

who: who is on the system.who(l) 

whodo: who is doing what.whodo(lM) 
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cd; change working directory.cd(l) 

chdir: change working directory.chdir(2) 

pwd: working directory name.pwd(l) 

write: write on a file.write(2) 

putpwent: write password file entry.putpwent(3C) 

wall: write to all users.wall(lM) 

write: write to another user..write(l) 

write: write on a file..write(2) 

write: write to another user.write(l) 

open: open for reading or writing.open(2) 

utmp, wtmp: utmp and wtmp entry format.utmp(5) 

fwtmp, wtmpfix: manipulate wtmp records.fwtmp(lM) 

format, utmp, wtmp: utmp and wtmp entry.utmp(5) 

records, fwtmp, wtmpfix: manipulate wtmp.fwtmp(lM) 

hunt-the-wumpus. wump: the game of.wump(6) 

list(s) and execute command, xargs: construct argument.xargs(l) 

programs, xref: cross reference for C.xref(l) 

jO,jl,jn, yO, yl, yn: bessel functions.bessel(3M) 

jO,jl,jn, yO, yl, yn: bessel functions.bessel(3M) 

compiler-compiler, yacc: yet another.yacc(l) 

jO, jl, jn, yO, yl, yn: bessel functions. .bessel(3M) 
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INTRO (1) 


INTRO(l) 


NAME 

intro - introduction to commands and application programs 
DESCRIPTION 

This section describes, in alphabetical order, publicly-accessible commands. Certain distinctions of pur¬ 
pose are made in the headings: 

(1) Commands of general utility. 

(1C) Commands for communication with other systems. 

(IG) Commands used primarily for graphics and computer-aided design. 

(IM) Commands used primarily for system maintenance. 

COMMAND SYNTAX 

Unless otherwise noted, commands described in this section accept options and other arguments according 
to the following syntax: 

name [option{s)] [cmdarg{s)] 
where: 


name 

option 


noargletter 

argletter 

optarg 

cmdarg 


The name of an executable file. 

- noargleter{s) or, 

- argletterooptarg 

where <> is optional white space. 

A single letter representing an option without an argument. 

A single letter representing an option requiring an argument. 

Argument (character string) satisfying preceding argletter. 

Path name (or other command argument) not beginning with - or, - by itself indicating the 
standard input. 


SEE ALSO 

getopt(l), getopt(3C). 

Section 6 of this volume for computer games. 
How to Get Started, at the front of this volume. 


DIAGNOSTICS 

Upon termination, each command returns two bytes of status, one supplied by the system and giving the 
cause for termination, and (in the case of “normal” termination) one supplied by the program (see wait(2) 
and exit(2)). The former byte is 0 for normal termination; the latter is customarily 0 for successful execu¬ 
tion and non-zero to indicate troubles such as erroneous parameters, bad or inaccessible data, or other 
inability to cope with the task at hand. It is called variously “exit code”, “exit status”, or “return code”, 
and is described only where special conventions are involved. 

BUGS 

Regretfully, many commands do not adhere to the aforementioned syntax. 



300 ( 1 ) 


300 ( 1 ) 


NAME 

300, 300s - handle special functions of DASI 300 and 300s terminals 
SYNOPSIS 

300 [ +12 ] [ -n ] [ -dt,l,c ] 

300s [ +12 ] [ -n ] [ -dt,l,c ] 

DESCRIPTION 

300 supports special functions and optimizes the use of the DASI 300 (GSI 300 or DTC 300) terminal; 300s 
performs the same functions for the DASI 300s (GSI 300s or DTC 300s) terminal. It converts half-line for¬ 
ward, half-line reverse, and full-line reverse motions to the correct vertical motions. It also attempts to 
draw Greek letters and other special symbols. It permits convenient use of 12-pitch text. It also reduces 
printing time 5 to 70%. 300 can be used to print equations neatly, in the sequence: 

neqn file ... | nroff I 300 

WARNING: if your terminal has a PLOT switch, make sure it is turned on before 300 is used. 

The behavior of 300 can be modified by the optional flag arguments to handle 12-pitch text, fractional line 
spacings, messages, and delays. 

+12 permits use of 12-pitch, 6 lines/inch text. DASI 300 terminals normally allow only two combi¬ 
nations: 10-pitch, 6 lines/inch, or 12-pitch, 8 lines/inch. To obtain the 12-pitch, 6 lines per inch 
combination, the user should turn the PITCH switch to 12, and use the +12 option. 

-n controls the size of half-line spacing. A half-line is, by default, equal to 4 vertical plot incre¬ 

ments. Because each increment equals 1/48 of an inch, a 10-pitch line-feed requires 8 incre¬ 
ments, while a 12-pitch line-feed needs only 6. The first digit of n overrides the default value, 
thus allowing for individual taste in the appearance of subscripts and superscripts. For example, 
nroff(l) half-lines could be made to act as quarter-lines by using -2. The user could also obtain 
appropriate half-lines for 12-pitch, 8 lines/inch mode by using the option -3 alone, having set 
the PITCH switch to 12-pitch. 

controls delay factors. The default setting is -d3,90,30. DASI 300 terminals sometimes produce 
peculiar output when faced with very long lines, too many tab characters, or long strings of 
blankless, non-identical characters. One null (delay) character is inserted in a line for every set 
of t tabs, and for every contiguous string of c non-blank, non-tab characters. If a line is longer 
than / bytes, l+(total length)/20 nulls are inserted at the end of that line. Items can be omitted 
from the end of the list, implying use of the default values. Also, a value of zero for t (c) results 
in two null bytes per tab (character). The former may be needed for C programs, the latter for 
files like /etc/passwd. Because terminal behavior varies according to the specific characters 
printed and the load on a system, the user may have to experiment with these values to get cor¬ 
rect output. The -d option exists only as a last resort for those few cases that do not otherwise 
print properly. For example, the file /etc/passwd may be printed using -d3,30,5. The value 
-d0,l is a good one to use for C programs that have many levels of indentation. 

Note that the delay control interacts heavily with the prevailing carriage return and line-feed 
delays. The .vtfy(l) inodes nlO cr2 or nIO cr3 are recommended for most uses. 

300 can be used with the nroff -s flag or rd requests, when it is necessary to insert paper manually or 
change fonts in the middle of a document. Instead of hitting the return key in these cases, you must use the 
line-feed key to get any response. 

In many (but not all) cases, the following sequences are equivalent: 

nroff -T300 files ... and nroff files ... I 300 
nroff -T300-12 files ... and nroff files ... I 300 +12 

The use of 300 can thus often be avoided unless special delays or options are required; in a few cases, how¬ 
ever, the additional movement optimization of 300 may produce better-aligned output. 
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The neqn{\) names of, and resulting output for, the Greek and special characters supported by 300 are 
shown in greek(l). 

SEE ALSO 

450(1), eqn(l), graph(lG), mesg(l), stty(l), tabs(l), tbl(l), tplot(lG), troff(l), greek(7). 

BUGS 

Some special characters cannot be correctly printed in column 1 because the print head cannot be moved to 
the left from there. 

If your output contains Greek and/or reverse line-feeds, use a friction-feed platen instead of a forms tractor; 
although good enough for drafts, the latter has a tendency to slip when reversing direction, distorting Greek 
characters and misaligning the first line of text after one or more reverse line-feeds. 
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NAME 

300, 300s - handle special functions of DASI 300 and 300s terminals 
SYNOPSIS 

300 [ +12 ] [ -n ] [ -dt,l,c ] 

300s [ +12 ] [ -n ] [ -dt,l,c ] 

DESCRIPTION 

300 supports special functions and optimizes the use of the DASI 300 (GSI 300 or DTC 300) terminal; 300s 
performs the same functions for the DASI 300s (GSI 300s or DTC 300s) terminal. It converts half-line for¬ 
ward, half-line reverse, and full-line reverse motions to the correct vertical motions. It also attempts to 
draw Greek letters and other special symbols. It permits convenient use of 12-pitch text. It also reduces 
printing time 5 to 70%. 300 can be used to print equations neatly, in the sequence: 

neqn file ... | nroff I 300 

WARNING: if your terminal has a PLOT switch, make sure it is turned on before 300 is used. 

The behavior of 300 can be modified by the optional flag arguments to handle 12-pitch text, fractional line 
spacings, messages, and delays. 

+12 permits use of 12-pitch, 6 lines/inch text. DASI 300 terminals normally allow only two combi¬ 
nations: 10-pitch, 6 lines/inch, or 12-pitch, 8 lines/inch. To obtain the 12-pitch, 6 lines per inch 
combination, the user should turn the PITCH switch to 12, and use the +12 option. 

-n controls the size of half-line spacing. A half-line is, by default, equal to 4 vertical plot incre¬ 

ments. Because each increment equals 1/48 of an inch, a 10-pitch line-feed requires 8 incre¬ 
ments, while a 12-pitch line-feed needs only 6. The first digit of n overrides the default value, 
thus allowing for individual taste in the appearance of subscripts and superscripts. For example, 
nroff(l) half-lines could be made to act as quarter-lines by using -2. The user could also obtain 
appropriate half-lines for 12-pitch, 8 lines/inch mode by using the option -3 alone, having set 
the PITCH switch to 12-pitch. 

controls delay factors. The default setting is -d3,90,30. DASI 300 terminals sometimes produce 
peculiar output when faced with very long lines, too many tab characters, or long strings of 
blankless, non-identical characters. One null (delay) character is inserted in a line for every set 
of t tabs, and for every contiguous string of c non-blank, non-tab characters. If a line is longer 
than / bytes, l+(total length)/20 nulls are inserted at the end of that line. Items can be omitted 
from the end of the list, implying use of the default values. Also, a value of zero for t (c) results 
in two null bytes per tab (character). The former may be needed for C programs, the latter for 
files like /etc/passwd. Because terminal behavior varies according to the specific characters 
printed and the load on a system, the user may have to experiment with these values to get cor¬ 
rect output. The -d option exists only as a last resort for those few cases that do not otherwise 
print properly. For example, the file /etc/passwd may be printed using -d3,30,5. The value 
-d0,l is a good one to use for C programs that have many levels of indentation. 

Note that the delay control interacts heavily with the prevailing carriage return and line-feed 
delays. The .vtfy(l) inodes nlO cr2 or nIO cr3 are recommended for most uses. 

300 can be used with the nroff -s flag or rd requests, when it is necessary to insert paper manually or 
change fonts in the middle of a document. Instead of hitting the return key in these cases, you must use the 
line-feed key to get any response. 

In many (but not all) cases, the following sequences are equivalent: 

nroff -T300 files ... and nroff files ... I 300 
nroff -T300-12 files ... and nroff files ... I 300 +12 

The use of 300 can thus often be avoided unless special delays or options are required; in a few cases, how¬ 
ever, the additional movement optimization of 300 may produce better-aligned output. 
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The neqn{\) names of, and resulting output for, the Greek and special characters supported by 300 are 
shown in greek(l). 

SEE ALSO 

450(1), eqn(l), graph(lG), mesg(l), stty(l), tabs(l), tbl(l), tplot(lG), troff(l), greek(7). 

BUGS 

Some special characters cannot be correctly printed in column 1 because the print head cannot be moved to 
the left from there. 

If your output contains Greek and/or reverse line-feeds, use a friction-feed platen instead of a forms tractor; 
although good enough for drafts, the latter has a tendency to slip when reversing direction, distorting Greek 
characters and misaligning the first line of text after one or more reverse line-feeds. 
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NAME 

300, 300s - handle special functions of DASI 300 and 300s terminals 
SYNOPSIS 

300 [ +12 ] [ -n ] [ -dt,l,c ] 

300s [ +12 ] [ -n ] [ -dt,l,c ] 

DESCRIPTION 

300 supports special functions and optimizes the use of the DASI 300 (GSI 300 or DTC 300) terminal; 300s 
performs the same functions for the DASI 300s (GSI 300s or DTC 300s) terminal. It converts half-line for¬ 
ward, half-line reverse, and full-line reverse motions to the correct vertical motions. It also attempts to 
draw Greek letters and other special symbols. It permits convenient use of 12-pitch text. It also reduces 
printing time 5 to 70%. 300 can be used to print equations neatly, in the sequence: 

neqn file ... | nroff I 300 

WARNING: if your terminal has a PLOT switch, make sure it is turned on before 300 is used. 

The behavior of 300 can be modified by the optional flag arguments to handle 12-pitch text, fractional line 
spacings, messages, and delays. 

+12 permits use of 12-pitch, 6 lines/inch text. DASI 300 terminals normally allow only two combi¬ 
nations: 10-pitch, 6 lines/inch, or 12-pitch, 8 lines/inch. To obtain the 12-pitch, 6 lines per inch 
combination, the user should turn the PITCH switch to 12, and use the +12 option. 

-n controls the size of half-line spacing. A half-line is, by default, equal to 4 vertical plot incre¬ 

ments. Because each increment equals 1/48 of an inch, a 10-pitch line-feed requires 8 incre¬ 
ments, while a 12-pitch line-feed needs only 6. The first digit of n overrides the default value, 
thus allowing for individual taste in the appearance of subscripts and superscripts. For example, 
nroff(l) half-lines could be made to act as quarter-lines by using -2. The user could also obtain 
appropriate half-lines for 12-pitch, 8 lines/inch mode by using the option -3 alone, having set 
the PITCH switch to 12-pitch. 

controls delay factors. The default setting is -d3,90,30. DASI 300 terminals sometimes produce 
peculiar output when faced with very long lines, too many tab characters, or long strings of 
blankless, non-identical characters. One null (delay) character is inserted in a line for every set 
of t tabs, and for every contiguous string of c non-blank, non-tab characters. If a line is longer 
than / bytes, l+(total length)/20 nulls are inserted at the end of that line. Items can be omitted 
from the end of the list, implying use of the default values. Also, a value of zero for t (c) results 
in two null bytes per tab (character). The former may be needed for C programs, the latter for 
files like /etc/passwd. Because terminal behavior varies according to the specific characters 
printed and the load on a system, the user may have to experiment with these values to get cor¬ 
rect output. The -d option exists only as a last resort for those few cases that do not otherwise 
print properly. For example, the file /etc/passwd may be printed using -d3,30,5. The value 
-d0,l is a good one to use for C programs that have many levels of indentation. 

Note that the delay control interacts heavily with the prevailing carriage return and line-feed 
delays. The .vtfy(l) inodes nlO cr2 or nIO cr3 are recommended for most uses. 

300 can be used with the nroff -s flag or rd requests, when it is necessary to insert paper manually or 
change fonts in the middle of a document. Instead of hitting the return key in these cases, you must use the 
line-feed key to get any response. 

In many (but not all) cases, the following sequences are equivalent: 

nroff -T300 files ... and nroff files ... I 300 
nroff -T300-12 files ... and nroff files ... I 300 +12 

The use of 300 can thus often be avoided unless special delays or options are required; in a few cases, how¬ 
ever, the additional movement optimization of 300 may produce better-aligned output. 
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The neqn{\) names of, and resulting output for, the Greek and special characters supported by 300 are 
shown in greek(l). 

SEE ALSO 

450(1), eqn(l), graph(lG), mesg(l), stty(l), tabs(l), tbl(l), tplot(lG), troff(l), greek(7). 

BUGS 

Some special characters cannot be correctly printed in column 1 because the print head cannot be moved to 
the left from there. 

If your output contains Greek and/or reverse line-feeds, use a friction-feed platen instead of a forms tractor; 
although good enough for drafts, the latter has a tendency to slip when reversing direction, distorting Greek 
characters and misaligning the first line of text after one or more reverse line-feeds. 
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NAME 

450 - handle special functions of the DASI 450 terminal 

SYNOPSIS 

450 

DESCRIPTION 

450 supports special functions of, and optimizes the use of, the DASI 450 terminal, or any terminal that is 
functionally identical, such as the DIABLO 1620 or XEROX 1700. It converts half-line forward, half-line 
reverse, and full-line reverse motions to the correct vertical motions. It also attempts to draw Greek letters 
and other special symbols in the same manner as 300(1). 450 can be used to print equations neatly, in the 
sequence: 

neqn file ... | nroff I 450 

WARNING: make sure that the PLOT switch on your terminal is ON before 450 is used. The SPACING 
switch should be put in the desired position (either 10- or 12-pitch). In either case, vertical spacing is 6 
lines/inch, unless dynamically changed to 8 lines per inch by an appropriate escape sequence. 

450 can be used with the nrojf(l) -s flag or .rd requests, when it is necessary to insert paper manually or 
change fonts in the middle of a document. Instead of hitting the return key in these cases, you must use the 
line-feed key to get any response. 

In many (but not all) cases, the use of 450 can be eliminated in favor of one of the following: 

nroff -T450 files ... 
or 

nroff -T450-12 files ... 

The use of 450 can thus often be avoided unless special delays or options are required; in a few cases, how¬ 
ever, the additional movement optimization of 450 may produce better-aligned output. 

The neqn{\) names of, and resulting output for, the Greek and special characters supported by 450 are 
shown in greek(l). 

SEE ALSO 

300(1), eqn(l), graph(lG), mesg(l), stty(l), tabs(l), tbl(l), tplot(lG), troff(l), greek(7). 

BUGS 

Some special characters cannot be correctly printed in column 1 because the print head cannot be moved to 
the left from there. 

If your output contains Greek and/or reverse line-feeds, use a friction-feed platen instead of a forms tractor; 
although good enough for drafts, the latter has a tendency to slip when reversing direction, distorting Greek 
characters and misaligning the first line of text after one or more reverse line-feeds. 
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NAME 

4014 - paginator for the Tektronix 4014 terminal 
SYNOPSIS 

4014 [ -t ] [ -n ] [ -cN ] [ -pL ] [ file ] 

DESCRIPTION 

The output of 4014 is intended for a Tektronix 4014 terminal; 4014 arranges for 66 lines to fit on the 
screen, divides the screen into N columns, and contributes an eight-space page offset in the (default) 
single-column case. Tabs, spaces, and backspaces are collected and plotted when necessary. TELETYPE nh 

Model 37 half- and reverse-line sequences are interpreted and plotted. At the end of each page, 4014 waits 
for a new-line (empty line) from the keyboard before continuing on to the next page. In this wait state, the 
command \cmd will send the cmd to the shell. 

The command line options are: 

-t Don’t wait between pages (useful for directing output into a file). 

-n Start printing at the current cursor position and never erase the screen. 

-cN Divide the screen into N columns and wait after the last column. 

-pL Set page length to L; L accepts the scale factors i (inches) and 1 (lines); default is lines. 

SEE ALSO 

pr(l),tc(l), troff(l). 
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NAME 

acct - overview of accounting and miscellaneous accounting commands 

SYNOPSIS 

acctdisk 


acctdusg [ -u file ] [ -p file ] > dtmp-file 
accton [file] 

acctwtmp [name[line]] »/usr/adin/wtmp 


DESCRIPTION 

Accounting software is structured as a set of tools (consisting of both C programs and shell procedures) that 
can be used to build accounting systems. Accf5/i(lM) describes the set of shell procedures built on top of 
the C programs. 

Connect time accounting is handled by various programs that write records into /usr/adm/utmp, as 
described in utmp{5). The programs described in acctcon{\yi) convert this file into session and charging 
records, which are then summarized by acctmerg{lM). 

Process accounting is performed by the UNIX kernel. Upon termination of a process, one record per pro¬ 
cess is written to a file (normally /usr/adm/pacct). The programs in acctprc^UA) summarize this data for 
charging purposes; acctcms{lM) is used to summarize command usage. Current process data may be 
examined using acctcom(l). 

Process accounting and connect time accounting (or any accounting records in the format described in 
acct{5)) can be merged and summarized into total accounting records by acctmerg (see facet format in 
acct{5)). Prtacct (see acctsh(lM)) is used to format any or all accounting records. 

Acctdisk reads lines that contain user ID, login name, and number of disk blocks and converts them to total 
accounting records that can be merged with other accounting records. 

Acctdusg reads its standard input (usually from find / -print) and computes disk resource consumption 
(including indirect blocks) by login. If -u is given, records consisting of those file names for which 
acctdusg charges no one are placed in file (a potential source for finding users trying to avoid disk charges). 
If -p is given, file is the name of the password file. This option is not needed if the password file is 

/etc/pass wd. 

Accton alone turns process accounting off. If file is given, it must be the name of an existing file, to which 
the kernel appends process accounting records (see acct{2) and iiccf(5)). 

Acctwtmp writes a wtmpifi) record to its standard output. The record contains the current time, name, and 
line. If line is omitted, a value is emitted that is interpreted by other programs as a reboot. For more pre¬ 
cise accounting, the following are recommended for use in reboot and shutdown procedures, respectively: 


acctwtmp 'uname*' »/usr/adm/wtmp 
acctwtmp reason »/usr/adm/wtmp 


FILES 

/etc/passwd 

/usr/lib/acct 

/usr/adm/pacct 

/usr/adm/wtmp 


used for login name to user ID conversions 
holds all accounting commands listed in 
sub-class IM of this manual 
current process accounting file 
login/logoff history file 


SEE ALSO 

acctcms(lM), acctcom(l), acctcon(lM), acctmerg(lM), acctprc(lM), acctsh(lM), fwtmp(lM), 
runacct(lM), acct(2), acct(5), utmp(5). 

The UNIX Accounting System by H. S. McCreary. 
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NAME 

acctcms - command summary from per-process accounting records 
SYNOPSIS 

acctcms [options] files 
DESCRIPTION 

Acctcms reads one or more files, normally in the form described in acctifi). It adds all records for processes 
that executed identically-named commands, sorts them, and writes them to the standard output, normally 
using an internal summary format. The options are: 

-a Print output in ASCII rather than in the internal summary format. The output includes command 
name, number of times executed, total kcore-minutes, total CPU minutes, total real minutes, mean 
size (in K), mean CPU minutes per invocation, and “hog factor”, as in acctcom(l). Output is nor¬ 
mally sorted by total kcore-minutes. 

-c Sort by total CPU time, rather than total kcore-minutes. 

-j Combine all commands invoked only once under “***other”. 

-n Sort by number of command invocations. 

-s Any file names encountered hereafter are already in internal summary format. 

A typical sequence for performing daily command accounting and for maintaining a running total is: 

acctcms file ... >today 

cp total previoustotal 

acctcms -s today previoustotal >total 

acctcms -a -s today 

SEE ALSO 

acct(lM), acctcom(l), acctcon(lM), acctmerg(lM), acctprc(lM), acctsh(lM), fwtmp(lM), runacct(lM), 
acct(2), acct(5), utmp(5). 
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NAME 

acctcom - search and print process accounting file(s) 
SYNOPSIS 

acctcom [[options][file]] . .. 


DESCRIPTION 

Acctcom reads file, the standard input, or /usr/adm/pacct, in the form described by acct{5) and writes 
selected records to the standard output. Each record represents the execution of one process. The output 
shows the COMMAND NAME, USER, TTYNAME, START TIME, END TIME, REAL (SEC), CPU (SEC), 
MEAN SIZE(K), and optionally, F forklexec flag: 1 for/or/: without exec) and STAT (the system exit 
status). 

The command name is prepended with a # if it was executed with super-user privileges. If a process is not 
associated with a known terminal, a ? is printed in the TTYNAME field. 

If no files are specified, and if the standard input is associated with a terminal or /dev/null (as is the case 
when using & in the shell), /usr/adin/pacct is read, otherwise the standard input is read. 

If any file arguments are given, they are read in their respective order. Each file is normally read forward, 
i.e., in chronological order by process completion time. The file /usr/adm/pacct is usually the current file 
to be examined; a busy system may need several files, in which case all but the current will be found in 
/usr/adm/pacct.^. The options are: 


-b 

-f 

-h 


-k 

-m 

-r 

-t 

-V 

-I line 
-u user 


-g group 

-d mm/dd 

-s time 

-e time 

-n pattern 

-H factor 

-O time 
-C time 


Read backwards, showing latest commands first. 

Print xhtforktexec flag and system exit status columns in the output. 

Instead of mean memory size, show the fraction of total available CPU time consumed by the 
process during its execution. This “hog factor” is computed as: 

(total CPU time)/(elapsed time). 

Print columns containing the I/O counts in the output. 

Instead of memory size, show total kcore-minutes. 

Show mean core size (the default). 

Show CPU factor (user time/(system-time + user-time). 

Show separate system and user CPU times. 

Exclude column headings from the output. 

Show only processes belonging to terminal /dev//me. 

Show only processes belonging to user that may be specified by: a user ID, a login name that 
is then converted to a user ID, a # which designates only those processes executed with 
super-user privileges, or ? which designates only those processes associated with unknown 
user IDs. 

Show only processes belonging to group. The group may be designated by either the group 
ID or group name. 

Any time arguments following this flag are assumed to occur on the given month and day, 
rather than during the last 24 hours. This is needed for looking at old files. 

Show only those processes that existed on or after time, given in the form hnminisec. The 
:sec or :min:sec may be omitted. 

Show only those processes that existed on or before time. Using the same time for both -s 
and -e shows the processes that existed at time. 

Show only commands matching pattern that may be a regular expression as in ed{\) except 
that + means one or more occurrences. 

Show only processes that excQtd factor, where factor is the “hog factor” as explained in 
option -h above. 

Show only those processes with operating system CPU time that exceeds time. 

Show only those processes that exceed time that indicates the total CPU time. 


Listing options together has the effect of a logical and. 
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FILES 

/etc/passwd 

/usr/adm/pacct 

/etc/group 

SEE ALSO 

acct(lM), acctcms(lM), acctcon(lM), acctmerg(lM), acctprc(lM), acctsh(lM), fwtmp(lM), ps(l), 
runacct(lM), su(l), acct(2), acct(5), utmp(5). 

BUGS 

Acctcom only reports on processes that have terminated; use for active processes. 
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NAME 

acctcon - connect-time accounting 

SYNOPSIS 

acctconl [options] 

acctcon2 

DESCRIPTION 

Acctconl converts a sequence of login/logoff records read from its standard input to a sequence of records, 
one per login session. Its input should normally be redirected from /usr/adm/wtmp. Its output is ASCII, 
giving device, user ID, login name, prime connect time (seconds), non-prime connect time (seconds), ses¬ 
sion starting time (numeric), and starting date and time. The options are: 

-p Print input only, showing line name, login name, and time (in both numeric and date/time formats), 

-t Acctconl maintains a list of lines on which users are logged in. When it reaches the end of its 

input, it emits a session record for each line that still appears to be active. It normally assumes that 
its input is a current file, so that it uses the current time as the ending time for each session still in 
progress. The -t flag causes it to use, instead, the last time found in its input, thus assuring reason¬ 
able and repeatable numbers for non-current files. 

-I file File is created to contain a summary of line usage showing line name, number of minutes used, per¬ 
centage of total elapsed time used, number of sessions charged, number of logins, and number of 
logoffs. This file helps track line usage, identify bad lines, and find software and hardware oddities. 
Both hang-up and termination of the login shell generate a logoff record, so that the number of 
logoffs is often twice the number of sessions. 

-0 file File is filled with an overall record for the accounting period, giving starting time, ending time, 
number of reboots, and number of date changes. 

Acctconl expects as input a sequence of login session records and converts them into total accounting 
records (see facet format in accf(5)). 

EXAMPLES 

These commands are typically used as shown below. The file ctmp is created only for the use of 
acetpreiXM) commands: 

acctconl -t -1 lineuse -o reboots <wtmp I sort -i-ln +2 >ctmp 
acctcon2 <ctmp I acetmerg >ctacct 

FILES 

/usr/adm/wtmp 

SEE ALSO 

acct(lM), acctcms(lM), acctcom(l), acctmerg(lM), acctprc(lM), acctsh(lM), fwtmp(lM), runacct(lM), 
acct(2), acct(5), utmp(5). 

BUGS 

The line usage report is confused by date changes. Use wtmpfix (see fwtmp{lM)) to correct this situation. 
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NAME 

acctmerg - merge or add total accounting files 
SYNOPSIS 

acctmerg [options] [file] ... 

DESCRIPTION 

Acctmerg reads its standard input and up to nine additional files, all in the facet format (see acct{5)), or an 
ASCII version thereof. It merges these inputs by adding records whose keys (normally user ID and name) 
are identical, and expects the inputs to be sorted on those keys. Options are: 

-a Produce output in ASCII version of facet. 

-i Input files are in ASCII version of facet. 

-p Print input with no processing. 

-t Produce a single record that totals all input. 

-u Summarize by user ID, rather than user ID and name. 

-V Produce output in verbose ASCII format, with more precise notation for floating point numbers. 

The following sequence is useful for making “repairs” to any file kept in this format: 

acctmerg -v <filel >file2 

edit file! as desired... 
acctmerg -a <file2 >filel 

SEE ALSO 

acct(lM), acctcms(lM), acctcom(l), acctcon(lM), acctprc(lM), acctsh(lM), fwtmp(lM), runacct(lM), 
acct(2), acct(5), utmp(5). 
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NAME 

acctprc - process accounting 

SYNOPSIS 

acctprc 1 [ctmp] 

acctprc2 

DESCRIPTION 

Acctprcl reads input in the form described by acct(5), adds login names corresponding to user IDs, then 
writes for each process an ASCII line giving user ID, login name, prime CPU time (tics), non-prime CPU 
time (tics), and mean memory size (in 64-byte units). If ctmp is given, it is expected to contain a list of 
login sessions, in the form described in acctcon(].M), sorted by user ID and login name. If this file is not 
supplied, it obtains login names from the password file. The information in ctmp helps it distinguish 
among different login names that share the same user ID. 

Acctprcl reads records in the form written by acctprcl , summarizes them by user ID and name, then writes 
the sorted summaries to the standard output as total accounting records. 

These commands are typically used as shown below: 

acctprcl ctmp </usr/adm/pacct I acctprcl >ptacct 

FILES 

/etc/passwd 
SEE ALSO 

acct(lM), acctcms(lM), acctcom(l), acctcon(lM), acctmerg(lM), acctsh(lM), fwtmp(lM), runacct(lM), 
acct(2), acct(5), utmp(5). 

BUGS 

Although it is possible to distinguish among login names that share user IDs for commands run normally, it 
is difficult to do this for those commands run from cra«(lM), for example. More precise conversion can be 
done by faking login sessions on the console via the acctwtmp program in iicct(lM). 
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NAME 

acctsh - shell procedures for accounting 
SYNOPSIS 

chargefee login-name number 

ckpacct [blocks] 

dodisk 

lastlogin 

monacct number 

nulladm file 

prctmp 

prdaily 

prtacct file [ "heading" ] 
runacct [mmdd] [mmdd state] 
shutacct [ "reason" ] 
startup 

turnacct [ on I off I switch ] 

DESCRIPTION 

Chargefee is invoked to charge number dollars to login-name. A record is written to /usr/adm/fee, to be 
merged with other accounting records during the night. 

Ckpacct is initiated via cron. It periodically checks the size of /usr/adm/pacct. If the size exceeds blocks, 
1000 by default, turnacct will be invoked with argument switch. 

Dodisk is invoked by cron to perform the disk accounting functions. 

Lastlogin is invoked by runacct to update /usr/adm/acct/sum/loginlog, which shows the last date on 
which each person logged in. 

Monacct should be invoked once each month or each accounting period. Number indicates which month or 
period it is. It creates summary files in /usr/adm/acct/fiscal and restarts summary file in 
/usr/adm/acct/sum. Nulladm creates file with mode 644 and insures owner is adm. It is called by 
lastlogin, runacct, and turnacct. 

Prctmp can be used to print the session record file (normally /usr/adm/acct/nite/ctmp created by acctconl 
(see acctcon{\M)). 

Prdaily is invoked by runacct to print a report of the previous day’s accounting. The report resides in 
/usr/adm/acct/sum/rprtAxu: where joocx is the month and day of the report. The daily accounting reports 
may be printed (by the command “cat /usr/adm/acct/sum/rprt*’’) as often as desired and they must be 
explicitly deleted when no longer needed. 

Prtacct can be used to format and print any total accounting file. 

Runacct performs the accumulation of connect, process, fee, and disk accounting on a daily basis. It also 
creates summaries of command usage. For more information, see runacct{lM). 

Shutacct should be invoked during a system shutdown to turn process accounting off and append a “rea¬ 
son” record to /usr/adm/wtmp. Startup should be called by rc(8) to turn the accounting on whenever the 
system is brought up. 

Turnacct is an interface to accton (see accf(lM)) to turn process accounting on or off. The switch argu¬ 
ment moves the current /usr/adm/pacct to the next free name in /usr/adm/pacct[l-9], turns accounting off, 
then turns it back on again. This procedure is called by ckpacct via the cron to keep the pacct file size 
smaller. 
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FILES 


/usr/adm/fee 
/usr/adm/pacct 
/usr/adm/pacct[ 1 -9] 

/usr/adm/wtmp 

/usr/adm/wtmp[l-9] 

/usr/adm/acct/nite 

/usr/lib/acct 

/usr/adm/acct/sum 


accumulator for fees 

current file for per-process accounting 

used if pacct gets large and during 

execution of daily accounting procedure 

login/logoff summary 

used during daily accounting procedure 

working directory 

holds all accounting commands listed in 
sub-class IM of this manual 
summary directory, should be saved 


SEE ALSO 

acct(lM), acctcms(lM), acctcom(l), acctcon(lM), acctmerg(lM), acctprc(lM), fwtmp(lM), runacct(lM), 
acct(2), acct(5), utmp(5). 
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NAME 

adb - debugger 
SYNOPSIS 

adb [-w] [ objfil [ corfil ] ] 

DESCRIPTION 

Adb is a general purpose debugging program. It may be used to examine files and to provide a controlled 
environment for the execution of UNIX programs. 

Objfil is normally an executable program file, preferably containing a symbol table; if not then the symbolic 
features of adb cannot be used although the file can still be examined. The default for objfil is a.out. 
Corfil is assumed to be a core image file produced after executing objfil-, the default for corfil is core. 

Requests to adb are read from the standard input and responses are to the standard output. If the -w flag is 
present then both objfil and corfil are created if necessary and opened for reading and writing so that files 
can be modified using adb. Adb ignores QUIT; INTERRUPT causes return to the next adb command. 

In general requests to adb are of the form 

[ address ] [, count ] [ command ] [; ] 

If address is present then dot is set to address. Initially dot is set to 0. For most commands count 
specifies how many times the command will be executed. The default count is 1. Address and count are 
expressions. 

The interpretation of an address depends on the context it is used in. If a subprocess is being debugged then 
addresses are interpreted in the usual way in the address space of the subprocess. For further details of 
address mapping see ADDRESSES. 

EXPRESSIONS 

. The value of ffot. 

+ The value of dot incremented by the current increment. 

The value of dot decremented by the current increment. 

" The last address typed. 

integer An octal number if integer begins with a 0; a hexadecimal number if preceded by #; otherwise a 
decimal number. 

integer.fraction 

A 32 bit floating point number. 

'cccc' The ASCII value of up to 4 characters. \ may be used to escape a'. 

< name The value of name, which is either a variable name or a register name. Adb maintains a number of 
variables (see VARIABLES) named by single letters or digits. If name is a register name then the 
value of the register is obtained from the system header in corfil. The register names are rO ... rS 

sp pc ps. 

symbol A .symbol is a sequence of upper or lower case letters, underscores or digits, not starting with a 
digit. The value of the .symbol is taken from the symbol table in objfil. An initial _ or ~ will be 
prepended to symbol if needed. 

_ symbol 

In C, the “true name” of an external symbol begins with _. It may be necessary to utter this name 
to distinguish it from internal or hidden variables of a program. 

routine .name 

The address of the variable name in the specified C routine. Both routine and name are symbols. 
If name is omitted the value is the address of the most recently activated C stack frame corre¬ 
sponding to routine. 
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{exp ) The value of the expression exp. 

Monadic operators: 

*exp The contents of the location addressed by exp in corfil. 

@exp The contents of the location addressed by exp in ohjfil. 

-exp Integer negation. 

-exp Bitwise complement. 

Dyadic operators are left associative and are less binding than monadic operators. 
el +e2 Integer addition. 
el -e2 Integer subtraction. 
el *e2 Integer multiplication. 
el % el Integer division. 
el Seel Bitwise conjunction. 
el I el Bitwise disjunction. 
el #e2 El rounded up to the next multiple of el. 

COMMANDS 

Most commands consist of a verb followed by a modifier or list of modifiers. The following verbs are 
available. (The commands ? and / may be followed by *; see ADDRESSES for further details.) 

?/ Locations starting at address in objfil are printed according to the format/, dot is incremented by 
the sum of the increments for each format letter (q.v.). 

If Locations starting at address in corfil are printed according to the format/ and dot is incremented 
as for ?. 

=/ The value of address itself is printed in the styles indicated by the format /. (For i format ? is 
printed for the parts of the instruction that reference subsequent words.) 

A format consists of one or more characters that specify a style of printing. Each format character may be 
preceded by a decimal integer that is a repeat count for the format character. While stepping through a for¬ 
mat dot is incremented by the amount given for each format letter. If no format is given then the last for¬ 
mat is used. The format letters available are as follows: 

o 2 Print 2 bytes in octal. All octal numbers output by adb are preceded by 0. 

O 4 Print 4 bytes in octal, 

q 2 Print in signed octal. 

Q 4 Print long signed octal, 

d 2 Print in decimal. 

D 4 Print long decimal. 

X 2 Print 2 bytes in hexadecimal. 

X 4 Print 4 bytes in hexadecimal, 

u 2 Print as an unsigned decimal number. 

U 4 Print long unsigned decimal, 

f 4 Print the 32 bit value as a floating point number. 

F 8 Print double floating point, 

b 1 Print the addressed byte in octal, 

c 1 Print the addressed character. 

C 1 Print the addressed character using the following escape convention. Character values 
000 to 040 are printed as @ followed by the corresponding character in the range 0100 to 
0140. The character @ is printed as @@. 
s n Print the addressed characters until a zero character is reached. 
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S n Print a string using the @ escape convention, n is the length of the string including its 
zero terminator. 

Y 4 Print 4 bytes in date format (see crime (3C)). 

i n Print as PDP-11 instructions, n is the number of bytes occupied by the instruction. This 

style of printing causes variables 1 and 2 to be set to the offset parts of the source and 
destination respectively. 

a 0 Print the value of dot in symbolic form. Symbols are checked to ensure that they have an 
appropriate type as indicated below. 

/ local or global data symbol 
? local or global text symbol 
= local or global absolute symbol 

p 2 Print the addressed value in symbolic form using the same rules for symbol lookup as a. 

t 0 When preceded by an integer tabs to the next appropriate tab stop. For example, 8t 

moves to the next 8-space tab stop, 
r 0 Print a space, 

n 0 Print a new-line. 

0 Print the enclosed string. 

Dot is decremented by the current increment. Nothing is printed. 

+ Dot is incremented by 1. Nothing is printed. 

Dot is decremented by 1. Nothing is printed. 

new-line 

Repeat the previous command with a count of 1. 

[?/]l value mask 

Words starting at dot are masked with mask and compared with value until a match is found. If L 
is used then the match is for 4 bytes at a time instead of 2. If no match is found then dot is 
unchanged; otherwise dot is set to the matched location. If mask is omitted then -1 is used. 

[?/]w value ... 

Write the 2-byte value into the addressed location. If the command is W, write 4 bytes. Odd 
addresses are not allowed when writing to the subprocess address space. 

[?/]m hi elfl[V] 

New values for (bl, el,fl) are recorded. If less than three expressions are given then the remain¬ 
ing map parameters are left unchanged. If the ? or / is followed by * then the second segment 
(b2, e2 ,f2) of the mapping is changed. If the list is terminated by ? or / then the file (objfil or 
corfil respectively) is used for subsequent requests. (So that, for example, /m? will cause / to refer 
to objfil.) 

>name Dot is assigned to the variable or register named. 

! A shell is called to read the rest of the line following !. 

Smodifier 

Miscellaneous commands. The available modifiers are: 

</ Read commands from the file/ and return. 

>/ Send output to the file/, which is created if it does not exist, 
r Print the general registers and the instruction addressed by pc. Dot is set to pc. 

f Print the floating registers in single or double length. If the floating point status of ps is 

set to double (0200 bit) then double length is used anyway, 
b Print all breakpoints and their associated counts and commands. 

a ALGOL 68 stack backtrace. If address is given then it is taken to be the address of the 

current frame (instead of r4). If count is given then only the first count frames are 
printed. 
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c C stack backtrace. If address is given then it is taken as the address of the current frame 

(instead of r5). If C is used then the names and (16 bit) values of all automatic and static 
variables are printed for each active function. If count is given then only the first count 
frames are printed. 

e The names and values of external variables are printed, 

w Set the page width for output to address (default 80). 
s Set the limit for symbol matches to address (default 255). 

o All integers input are regarded as octal, 

d Reset integer input as described in EXPRESSIONS. 

q Exit from adh. 

V Print all non zero variables in octal, 

m Print the address map. 

'.modifier 

Manage a subprocess. Available modifiers are: 

be Set breakpoint at address. The breakpoint is executed count-1 times before causing a 
stop. Each time the breakpoint is encountered the command c is executed. If this com¬ 
mand sets dot to zero then the breakpoint causes a stop. 

d Delete breakpoint at address. 

r Run objfil as a subprocess. If address is given explicitly then the program is entered at 

this point; otherwise the program is entered at its standard entry point, count specifies 
how many breakpoints are to be ignored before stopping. Arguments to the subprocess 
may be supplied on the same line as the command. An argument starting with < or > 
causes the standard input or output to be established for the command. All signals are 
turned on on entry to the subprocess. 

cs The subprocess is continued with signal s (see .signal(2)). If address is given then the 
subprocess is continued at this address. If no signal is specified then the signal that 
caused the subprocess to stop is sent. Breakpoint skipping is the same as for r. 

ss As for c except that the subprocess is single stepped count times. If there is no current 
subprocess then objfil is run as a subprocess as for r. In this case no signal can be sent; 
the remainder of the line is treated as arguments to the subprocess. 

k The current subprocess, if any, is terminated. 

VARIABLES 

Adb provides a number of variables. Named variables are set initially by adb but are not used subse¬ 
quently. Numbered variables are reserved for communication as follows. 

0 The last value printed. 

1 The last offset part of an instruction source. 

2 The previous value of variable 1. 

On entry the following are set from the system header in the corfil. If corfil does not appear to be a core 
file then these values are set from objfil. 

b The base address of the data segment, 

d The data segment size, 

e The entry point. 

ni The “magic” number (0405, 0407, 0410 or 0411). 
s The stack segment size, 

t The text segment size. 

ADDRESSES 

The address in a file associated with a written address is determined by a mapping associated with that file. 
Each mapping is represented by two triples (bl, el, fl) and {b2, e2,f2) and the file address corresponding 
to a written address is calculated as follows: 
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bl<address<el ^ file address=address+fl-bl 
otherwise 

b2<address<e2 ^ file address-address+f2-b2, 

otherwise, the requested address is not legal. In some cases (e.g. for programs with separated I and D 
space) the two segments for a file may overlap. If a ? or / is followed by an * then only the second triple is 
used. 

The initial setting of both mappings is suitable for normal a.out and core files. If either file is not of the 
kind expected then, for that file, bl is set to 0, el is set to the maximum file size and/i is set to 0; in this 
way the whole file can be examined with no address translation. 

In order for adb to be used on large files all appropriate values are kept as signed 32 bit integers. 

FILES 

/dev/mem 

/dev/swap 

a.out 

core 

SEE ALSO 

ptrace(2), a.out(5), core(5). 

DIAGNOSTICS 

“Adb” when there is no current command or format. Comments about inaccessible files, syntax errors, 
abnormal termination of commands, etc. Exit status is 0, unless last command failed or returned nonzero 
status. 

BUGS 

A breakpoint set at the entry point is not effective on initial entry to the program. 

When single stepping, system calls do not count as an executed instruction. 

Local variables whose names are the same as an external variable may foul up the accessing of the external. 



ADMIN(l) 


ADMIN(l) 


NAME 

admin - create and administer SCCS files 
SYNOPSIS 

admin [-n] [-i[name]] [-rrel] [-t[name]] [-fflag[flag-val]] [-dflag[flag-val]] [-alogin] [-elogin] 
[-m[mrlist]] [-y[comment]] [-h] [-z] files 

DESCRIPTION 

Admin is used to create new SCCS files and change parameters of existing ones. Arguments to admin, 
which may appear in any order, consist of keyletter arguments, which begin with and named files (note 
that SCCS file names must begin with the characters s.)- If a named file doesn’t exist, it is created, and its 
parameters are initialized according to the specified keyletter arguments. Parameters not initialized by a 
keyletter argument are assigned a default value. If a named file does exist, parameters corresponding to 
specified keyletter arguments are changed, and other parameters are left as is. 

If a directory is named, admin behaves as though each file in the directory were specified as a named file, 
except that non-SCCS files (last component of the path name does not begin with s.) and unreadable files 
are silently ignored. If a name of - is given, the standard input is read; each line of the standard input is 
taken to be the name of an SCCS file to be processed. Again, non-SCCS files and unreadable files are 
silently ignored. 

The keyletter arguments are as follows. Each is explained as though only one named file is to be processed 
since the effects of the arguments apply independently to each named file. 

-n This keyletter indicates that a new SCCS file is to be created. 

-\[name] The name of a file from which the text for a new SCCS file is to be taken. The text 

constitutes the first delta of the file (see -r keyletter for delta numbering scheme). 
If the i keyletter is used, but the file name is omitted, the text is obtained by read¬ 
ing the standard input until an end-of-file is encountered. If this keyletter is omit¬ 
ted, then the SCCS file is created empty. Only one SCCS file may be created by an 
admin command on which the i keyletter is supplied. Using a single admin to cre¬ 
ate two or more SCCS files require that they be created empty (no -i keyletter). 
Note that the -i keyletter implies the -n keyletter. 

-rrel The release into which the initial delta is inserted. This keyletter may be used 

only if the -i keyletter is also used. If the -r keyletter is not used, the initial delta 
is inserted into release 1. The level of the initial delta is always 1 (by default ini¬ 
tial deltas are named 1.1). 

-t[name] The name of a file from which descriptive text for the SCCS file is to be taken. If 

the -t keyletter is used and admin is creating a new SCCS file (the -n and/or -i 
keyletters also used), the descriptive text file name must also be supplied. In the 
case of existing SCCS files: (1) a -t keyletter without a file name causes removal of 
descriptive text (if any) currently in the SCCS file, and (2) a -t keyletter with a file 
name causes text (if any) in the named file to replace the descriptive text (if any) 
currently in the SCCS file. 

-fflag This keyletter specifies a flag, and, possibly, a value for the flag, to be placed in 

the SCCS file. Several f keyletters may be supplied on a single admin command 
line. The allowable flags and their values are: 

b Allows use of the -b keyletter on a get{\) command to create branch deltas. 

cceil The highest release (i.e., “ceiling”), a number less than or equal to 9999, which 
may be retrieved by a get{l) command for editing. The default value for an 
unspecified c flag is 9999. 

ffloor The lowest release (i.e., “floor”), a number greater than 0 but less than 9999, 
which may be retrieved by a get{\) command for editing. The default value for an 
unspecified f flag is 1. 
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-dflag 


-alogin 


-elogin 


dSID The default delta number (SID) to be used by a get(l) command. 

i Causes the "No id keywords (ge6)" message issued by get(l) or delta(l) to be 

treated as a fatal error. In the absence of this flag, the message is only a warning. 
The message is issued if no SCCS identification keywords (see get(l)) are found in 
the text retrieved or stored in the SCCS file. 

j Allows concurrent ger(l) commands for editing on the same SID of an SCCS file. 

This allows multiple concurrent updates to the same version of the SCCS file. 

Mist A list of releases to which deltas can no longer be made (get -e against one of 
these “locked” releases fails). The list has the following syntax: 

<Iist> ::= <range> | <list> , <range> 

<range> : := RELEASE NUMBER \ a 

The character a in the list is equivalent to specifying all releases for the named 
SCCS file. 

n Causes delta(l) to create a “null” delta in each of those releases (if any) being 
skipped when a delta is made in a new release (e.g., in making delta 5.1 after delta 
2.7, releases 3 and 4 are skipped). These null deltas serve as “anchor points” so 
that branch deltas may later be created from them. The absence of this flag causes 
skipped releases to be non-existent in the SCCS file preventing branch deltas from 
being created from them in the future. 

qtext User definable text substituted for all occurrences of the %Q% keyword in SCCS 
file text retrieved by get(l). 

mmod Module name of the SCCS file substituted for all occurrences of the %M% key¬ 
word in SCCS file text retrieved by get(\). If the m flag is not specified, the value 
assigned is the name of the SCCS file with the leading s. removed. 

ttype Type of module in the SCCS file substituted for all occurrences of %Y% keyword 
in SCCS file text retrieved by get{\). 

\\pgm] Causes delta{\) to prompt for Modification Request {MR) numbers as the reason 
for creating a delta. The optional value specifies the name of an MR number valid¬ 
ity checking program (see delta{\)). (If this flag is set when creating an SCCS file, 
the m keyletter must also be used even if its value is null). 

Causes removal (deletion) of the specified flag from an SCCS file. The -d keylet¬ 
ter may be specified only when processing existing SCCS files. Several -d keylet- 
ters may be supplied on a single admin command. See the -f keyletter for allow¬ 
able names. 

Mist A list of releases to be “unlocked”. See the -f keyletter for a description of the 1 
flag and the syntax of a list. 

A login name, or numerical UNIX group ID, to be added to the list of users which 
may make deltas (changes) to the SCCS file. A group ID is equivalent to specify¬ 
ing all login names common to that group ID. Several a keyletters may be used on 
a single admin command line. As many logins, or numerical group IDs, as desired 
may be on the list simultaneously. If the list of users is empty, then anyone may 
add deltas. 

A login name, or numerical group ID, to be erased from the list of users allowed to 
make deltas (changes) to the SCCS file. Specifying a group ID is equivalent to 
specifying all login names common to that group ID. Several e keyletters may be 
used on a single admin command line. 
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—y{comment\ 


-m[mrlist] 


-h 


The comment text is inserted into the SCCS file as a comment for the initial delta 
in a manner identical to that of delta{\). Omission of the -y keyletter results in a 
default comment line being inserted in the form: 

date and time created YY/MMlDD HH:MM:SS by login 

The -y keyletter is valid only if the -i and/or -n keyletters are specified (i.e., a 
new SCCS file is being created). 

The list of Modification Requests (MR) numbers is inserted into the SCCS file as 
the reason for creating the initial delta in a manner identical to delta(\). The v flag 
must be set and the MR numbers are validated if the v flag has a value (the name of 
an MR number validation program). Diagnostics will occur if the v flag is not set 
or MR validation fails. 

Causes admin to check the structure of the SCCS file (see sccsjile(5)), and to com¬ 
pare a newly computed check-sum (the sum of all the characters in the SCCS file 
except those in the first line) with the check-sum that is stored in the first line of 
the SCCS file. Appropriate error diagnostics are produced. 

This keyletter inhibits writing on the file, so that it nullifies the effect of any other 
keyletters supplied, and is, therefore, only meaningful when processing existing 

files. 

The SCCS file check-sum is recomputed and stored in the first line of the SCCS file 
(see -h, above). 

Note that use of this keyletter on a truly corrupted file may prevent future detec¬ 
tion of the corruption. 


FILES 

The last component of all SCCS file names must be of the form s.file-name. New SCCS files are given mode 
444 (see chmod{\)). Write permission in the pertinent directory is, of course, required to create a file. All 
writing done by admin is to a temporary x-file, called x.file-name, (see get(l)), created with mode 444 if the 
admin command is creating a new SCCS file, or with the same mode as the SCCS file if it exists. After suc¬ 
cessful execution of admin, the SCCS file is removed (if it exists), and the x-file is renamed with the name 
of the SCCS file. This ensures that changes are made to the SCCS file only if no errors occurred. 

It is recommended that directories containing SCCS files be mode 755 and that SCCS files themselves be 
mode 444. The mode of the directories allows only the owner to modify SCCS files contained in the direc¬ 
tories. The mode of the SCCS files prevents any modification at all except by SCCS commands. 

If it should be necessary to patch an SCCS file for any reason, the mode may be changed to 644 by the 
owner allowing use of ed(\). Care must he taken! The edited file should always be processed by an admin 
-h to check for corruption followed by an admin -z to generate a proper check-sum. Another admin -h is 
recommended to ensure the SCCS file is valid. 


Admin also makes use of a transient lock file (called z.file-name), which is used to prevent simultaneous 
updates to the SCCS file by different users. See get(\) for further information. 

SEE ALSO 

delta(l), ed(l), get(l), help(l), prs(l), what(l), sccsfile(5). 

Source Code Control System User’s Guide by L. E. Bonanni and C. A. Salemi. 

DIAGNOSTICS 

Use help(\.) for explanations. 
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NAME 

ar - archive and library maintainer 

SYNOPSIS 

ar key [ posname ] afile name ... 

DESCRIPTION 

Ar maintains groups of files combined into a single archive file. Its main use is to create and update library 
files as used by the link editor. It can be used, though, for any similar purpose. 

Ar can read archive files produced in either PDP-11 or VAX-11/780 format (see ar(5)). However, when ar 
creates an archive, it always creates the header in the format of the local system. A conversion program 
exists to convert PDP-11 archives to VAX-11/780 archive format (see arcv(l)). This feature is useful only 
for source archive files. Individual files are inserted without conversion into the archive file. 

Key is one character from the set drqtpmx, optionally concatenated with one or more of vuaibcl. Afile is 
the archive file. The names are constituent files in the archive file. The meanings of the key characters are: 

d Delete the named files from the archive file. 

r Replace the named files in the archive file. If the optional character u is used with r, then only 

those files with modified dates later than the archive files are replaced. If an optional positioning 
character from the set abi is used, then the posname argument must be present and specifies that 

new files are to be placed after (a) or before (b or i) posname. Otherwise new files are placed at 

the end. 

q Quickly append the named files to the end of the archive file. Optional positioning characters are 

invalid. The command does not check whether the added members are already in the archive. 
Useful only to avoid quadratic behavior when creating a large archive piece-by-piece. 

t Print a table of contents of the archive file. If no names are given, all files in the archive are 

tabled. If names are given, only those files are tabled. 

p Print the named files in the archive. 

m Move the named files to the end of the archive. If a positioning character is present, then the 
posname argument must be present and, as in r, specifies where the files are to be moved. 

X Extract the named files. If no names are given, all files in the archive are extracted. In neither case 

does X alter the archive file. 

V Verbose. Under the verbose option, ar gives a file-by-file description of the making of a new 

archive file from the old archive and the constituent files. When used with t, it gives a long listing 
of all information about the files. When used with x, it precedes each file with a name. 

c Create. Normally ar will create afile when it needs to. The create option suppresses the normal 

message that is produced when afile is created. 

1 Local. Normally ar places its temporary files in the directory /tmp. This option causes them to be 

placed in the local directory. 

FILES 

/tmp/v* temporaries 

SEE ALSO 

arcv(l), ld(l),lorder(l), ar(5). 

BUGS 

If the same file is mentioned twice in an argument list, it may be put in the archive twice. 
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NAME 

arcv - convert archive files from PDP-11 to VAX-11/780 format 

SYNOPSIS 

arcv files 

DESCRIPTION 

Arcv converts source archive files from the PDP-11 format to the VAX-11/780 format. Because each con¬ 
verted file is copied over the original file, arcv runs with all interrupts turned off. 

FILES 

/tmp/arc* 

SEE ALSO 

ar(l), ar(5). 
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NAME 

as - assembler for PDP-11 

SYNOPSIS 

as [ - ] [ -o objfile ] file ... 

DESCRIPTION 

As assembles the concatenation of the named files. If the optional first argument - is used, all undefined 
symbols in the assembly are treated as global. 

The output of the assembly is left on the file objfile -, if that is omitted, a.out is used. It is executable if no 
errors occurred during the assembly, and if there were no unresolved external references. 

FILES 

/lib/as2 pass 2 of the assembler 

/tmp/atm[l-3]? temporary 

a.out object 

SEE ALSO 

adb(l), ld(l), nm(l), a.out(5). 

UNIX Assembler Manual by D. M. Ritchie 

DIAGNOSTICS 

If the name chosen for the output file is of the form *?.[cs], the assembler issues an appropriate complaint 
and quits. When an input file cannot be read, its name followed by a question mark is typed and assembly 
ceases. When syntactic or semantic errors occur, a single-character diagnostic is typed out together with 
the line number and the file name in which it occurred. Errors in pass 1 cause cancellation of pass 2. The 
possible errors are: 

) Parentheses error 

] Parentheses error 

< String not terminated properly 

* Indirection used illegally 

. Illegal assignment to . 

a Error in address 

b Branch instruction is odd or too remote 

e Error in expression 

f Error in local (f or b) type symbol 

g Garbage (unknown) character 

i End of file inside an .if 

m Multiply-defined symbol as label 

o Word quantity assembled at odd address 

p . different in pass 1 and 2 

r Relocation error 

u Undefined symbol 

X Syntax error 

BUGS 

Syntax errors can cause incorrect line numbers in subsequent diagnostics. 
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NAME 

as ~ assembler for VAX-11/780 

SYNOPSIS 

as [ -dl24 ] [ -o objfile ] [ name ] 

DESCRIPTION 

As assembles the named file, or the standard input if no file name is specified. The optional argument -d 
may be used to specify the number of bytes to be assembled for offsets which involve forward or external 
references, which have sizes unspecified in the assembly language. The default is four bytes, i.e., -d4. All 
undefined symbols in the assembly are treated as global. 

The output of the assembly is left on the file objfile ■, if that is omitted, a.out is used. It is executable if no 
errors occurred during the assembly, and if there were no unresolved external references. 

FILES 

/tmp/as* temporary 

/tmp/a[ab][a-h]t* temporary 
a.out object 

SEE ALSO 

adb(l), ld(l), nm(l), sdb(l), a.out(5). 
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NAME 

awk - pattern scanning and processing language 
SYNOPSIS 

awk [ -Fc ] [ prog ] [ files ] 

DESCRIPTION 

Awk scans each input file for lines that match any of a set of patterns specified in prog. With each pattern 
in prog there can be an associated action that will be performed when a line of 2 Lfile matches the pattern. 
The set of patterns may appear literally as prog, or in a file specified as -f file. The prog string should be 
enclosed in single quotes (') to protect it from the shell. 

Files are read in order; if there are no files, the standard input is read. The file name - means the standard 
input. Each line is matched against the pattern portion of every pattern-action statement; the associated 
action is performed for each matched pattern. 

An input line is made up of fields separated by white space. (This default can be changed by using FS, see 
below). The fields are denoted $1, $2,...; $0 refers to the entire line. 

A pattern-action statement has the form: 
pattern { action } 

A missing action means print the line; a missing pattern always matches. An action is a sequence of state¬ 
ments. A statement can be one of the following: 

if ( conditional ) statement [ else statement ] 
while ( conditional ) statement 

for ( expression ; conditional ; expression ) statement 

break 

continue 

{ [ statement ] ... } 

variable = expression 

print [ expression-list ] [ >expression ] 

printf format [ , expression-list ] [ >expression ] 

next # skip remaining patterns on this input line 

exit # skip the rest of the input 

Statements are terminated by semicolons, new-lines, or right braces. An empty expression-list stands for 
the whole line. Expressions take on string or numeric values as appropriate, and are built using the opera¬ 
tors +, *, /, %, and concatenation (indicated by a blank). The C operators ++, —, +=, -=, *=, /=, and 

%= are also available in expressions. Variables may be scalars, array elements (denoted x[i]) or fields. 
Variables are initialized to the null string. Array subscripts may be any string, not necessarily numeric; this 
allows for a form of associative memory. String constants are quoted ("). 

The print statement prints its arguments on the standard output (or on a file if >expr is present), separated 
by the current output field separator, and terminated by the output record separator. The printf statement 
formats its expression list according to the format (see printf(3S)). 

The built-in function length returns the length of its argument taken as a string, or of the whole line if no 
argument. There are also built-in functions exp, log, sqrt, and int. The last truncates its argument to an 
integer; suhstr{s,m,n) returns the n-character substring of s that begins at position m. The function 
sprintfifint, expr, expr,...) formats the expressions according to the printf(3S) format given byj^r and 
returns the resulting string. 

Patterns are arbitrary Boolean combinations ( !, I I, &&, and parentheses) of regular expressions and rela¬ 
tional expressions. Regular expressions must be surrounded by slashes and are as in egrep (see grep(\)). 
Isolated regular expressions in a pattern apply to the entire line. Regular expressions may also occur in 
relational expressions. A pattern may consist of two patterns separated by a comma; in this case, the action 
is performed for all lines between an occurrence of the first pattern and the next occurrence of the second. 
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A relational expression is one of the following: 

expression matchop regular-expression 
expression relop expression 

where a relop is any of the six relational operators in C, and a matchop is either *■ (for contains) or !“ (for 
does not contain). A conditional is an arithmetic expression, a relational expression, or a Boolean combi¬ 
nation of these. 

The special patterns BEGIN and END may be used to capture control before the first input line is read and 
after the last. BEGIN must be the first pattern, END the last. 

A single character c may be used to separate the fields by starting the program with: 

BEGIN { FS = c } 
or by using the -Fc option. 

Other variable names with special meanings include NF, the number of fields in the current record; NR, the 
ordinal number of the current record; FILENAME, the name of the current input file; OFS, the output field 
separator (default blank); ORS, the output record separator (default new-line); and OFMT, the output format 
for numbers (default %.6g). 

EXAMPLES 

Print lines longer than 72 characters: 
length > 72 

Print first two fields in opposite order: 

{ print $2, $1 } 

Add up first column, print sum and average: 

{ s += $1 } 

END { print "sum is", s, " average is", s/NR } 

Print fields in reverse order: 

{ for (i = NF; i > 0; —i) print $i } 

Print all lines between start/stop pairs: 

/start/, /stop/ 

Print all lines whose first field is different from previous one: 

$1 != prev { print; prev = $1 } 

SEE ALSO 

grep(l), lex(l), sed(l). 

Awk-A Pattern Scanning and Processing Language by A. V. Aho, B. W. Kernighan, and P. J. Weinberger. 

BUGS 

Input white space is not preserved on output if fields are involved. 

There are no explicit conversions between numbers and strings. To force an expression to be treated as a 
number add 0 to it; to force it to be treated as a string concatenate the null string (" ") to it. 
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NAME 

banner - make posters 

SYNOPSIS 

banner strings 

DESCRIPTION 

Banner prints its arguments (each up to 10 characters long) in large letters on the standard output. 
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NAME 

basename, dirname - deliver portions of path names 
SYNOPSIS 

basename string [ suffix ] 
dirname string 

DESCRIPTION 

Basename deletes any prefix ending in / and the suffix (if present in string) from string, and prints the 
result on the standard output. It is normally used inside substitution marks (' ') within shell procedures. 

Dirname delivers all but the last level of the path name in string. 

EXAMPLES 

The following example, invoked with the argument /usr/src/cmd/cat.c, compiles the named file and moves 
the output to a file named cat in the current directory: 

cc $1 

mv a.out ^basename $1 .c' 

The following example will set the shell variable NAME to /usr/src/cmd: 

NAMEs:'' dirname /usr/src/cmd/cat.c' 

SEE ALSO 

sh(l). 
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NAME 

be - arbitrary-precision arithmetic language 
SYNOPSIS 

be [-C ][-!][ file...] 

DESCRIPTION 

Be is an interactive processor for a language that resembles C but provides unlimited precision arithmetic. 
It takes input from any files given, then reads the standard input. The -I argument stands for the name of an 
arbitrary precision math library. The syntax for he programs is as follows; L means letter a-z, E means 
expression, S means statement. 

Comments 

are enclosed in /* and */. 

Names 

simple variables: L 
array elements: L [ E ] 

The words “ibase”, “obase”, and “scale” 

Other operands 

arbitrarily long numbers with optional sign and decimal point. 

(E) 
sqrt (E) 

length (E ) number of significant decimal digits 
scale (E ) number of digits right of decimal point 

L(E,...,E) 

Operators 

+ -*/%^(%is remainder; is power) 

++ — (prefix and postfix; apply to names) 

== <= >=!=<> 

Statements 

E 

{S;...;S} 
if ( E) S 
while ( E ) S 
for ( E ; E ; E) S 
null statement 
break 
quit 

Function definitions 

defineL(L,...,L) { 
auto L,..., L 
S; ... S 
return (E) 

) 

Functions in -1 math library 
s(x) sine 

c(x) cosine 

e(x) exponential 

l(x) log 

a(x) arctangent 

j(n,x) Bessel function 
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All function arguments are passed by value. 

The value of a statement that is an expression is printed unless the main operator is an assignment. Either 
semicolons or new-lines may separate statements. Assignment to scale influences the number of digits to 
be retained on arithmetic operations in the manner of dc{\). Assignments to ibase or abase set the input 
and output number radix respectively. 

The same letter may be used as an array, a function, and a simple variable simultaneously. All variables are 
global to the program. “Auto” variables are pushed down during function calls. When using arrays as 
function arguments or defining them as automatic variables empty square brackets must follow the array 
name. 

Be is actually a preprocessor for dc(].), which it invokes automatically, unless the -c (compile only) option 
is present. In this case the dc input is sent to the standard output instead. 

EXAMPLE 

scale = 20 
define e(x){ 

auto a, b, c, i, s 
a= 1 
b= 1 
s= 1 

for(i=l; l==l;i++){ 
a = a*x 
b = b*i 
c = a/b 

if(c == 0) return(s) 
s = s+c 


defines a function to compute an approximate value of the exponential function and 
for(i=l; i<=10; i++) e(i) 

prints approximate values of the exponential function of the first ten integers. 

FILES 

/usr/lib/lib.b mathematical library 

/usr/bin/dc desk calculator proper 

SEE ALSO 

dc(l). 

BC - An Arbitrary Precision Desk-Calculator Language 
by L. L. Cherry and R. Morris. 

BUGS 

No &&, I I yet. 

For statement must have all three E’s. 

Quit is interpreted when read, not when executed. 
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NAME 

bcopy - interactive block copy 

SYNOPSIS 

/etc/bcopy 

DESCRIPTION 

Bcopy dates from a time when neither the UNIX file system nor the DEC disk drives were as reliable as they 
are now. Bcopy copies from and to files starting at arbitrary block (512-byte) boundaries. 

The following questions are asked: 

to: (you name the file or device to be copied to), 

offset: (you provide the starting “to” block number), 
from: (you name the file or device to be copied from), 
offset: (you provide the starting “from” block number), 
count: (you reply with the number of blocks to be copied). 

After count is exhausted, the from question is repeated (giving you a chance to concatenate blocks at the 
to+offset+count location). If you answer from with a carriage return, everything starts over. 

Two consecutive carriage returns terminate bcopy. 

SEE ALSO 

cpio(l), dd(l). 
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NAME 

bdiff-big diff 
SYNOPSIS 

bdiff filel file2 [n] [-s] 

DESCRIPTION 

Bdijf is used in a manner analogous to dijf{ 1) to find which lines must be changed in two files to bring them 
into agreement. Its purpose is to allow processing of files which are too large for dijf. Bdiff ignores lines 
common to the beginning of both files, splits the remainder of each file into «-line segments, and invokes 
diff upon corresponding segments. The value of n is 3500 by default. If the optional third argument is 
given, and it is numeric, it is used as the value for n. This is useful in those cases in which 3500-line seg¬ 
ments are too large for diff, causing it to fail. If filel (filel) is the standard input is read. The optional -s 
(silent) argument specifies that no diagnostics are to be printed by bdiff (note, however, that this does not 
suppress possible exclamations by diff. If both optional arguments are specified, they must appear in the 
order indicated above. 

The output of bdiff is exactly that of diff, with line numbers adjusted to account for the segmenting of the 
files (that is, to make it look as if the files had been processed whole). Note that because of the segmenting 
of the files, bdiff does not necessarily find a smallest sufficient set of file differences. 

FILES 

/tmp/bd????? 

SEE ALSO 

diff(l). 

DIAGNOSTICS 

Use helpil) for explanations. 
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NAME 

bfs - big file scanner 

SYNOPSIS 

bfs [ - ] name 

DESCRIPTION 

Bfs is (almost) like ed{l) except that it is read-only and processes much larger files. Files can be up to 
1024K bytes (the maximum possible size) and 32K lines, with up to 255 characters per line. Bfs is usually 
more efficient than ed for scanning a file, since the file is not copied to a buffer. It is most useful for identi¬ 
fying sections of a large file where csplitif) can be used to divide it into more manageable pieces for edit¬ 
ing. 

Normally, the size of the file being scanned is printed, as is the size of any file written with the w command. 
The optional - suppresses printing of sizes. Input is prompted with * if P and a carriage return are typed as 
in ed. Prompting can be turned off again by inputting another P and carriage return. Note that messages 
are given in response to errors if prompting is turned on. 

All address expressions described under ed are supported. In addition, regular expressions may be sur¬ 
rounded with two symbols besides / and ?: > indicates downward search without wrap-around, and < indi¬ 
cates upward search without wrap-around. Since hfs uses a different regular expression-matching routine 
from ed, the regular expressions accepted are slightly wider in scope (see regex{yK)). There is a slight dif¬ 
ference in mark names: only the letters a through z may be used, and all 26 marks are remembered. 

The e, g, v, k, n, p, q, w, =, ! and null commands operate as described under ed. Commands such as-, 

+++-, +++=, -12, and +4p are accepted. Note that l,10p and 1,10 will both print the first ten lines. The f 
command only prints the name of the file being scanned; there is no remembered file name. The w com¬ 
mand is independent of output diversion, truncation, or crunching (see the xo, xt and xc commands, below). 
The following additional commands are available: 

xffile 

Further commands are taken from the named file. When an end-of-file is reached, an interrupt 
signal is received or an error occurs, reading resumes with the file containing the xf. Xf com¬ 
mands may be nested to a depth of 10. 

xo [file ] 

Further output from the p and null commands is diverted to the named yi/e, which, if necessary, 
is created mode 666. If file is missing, output is diverted to the standard output. Note that 
each diversion causes truncation or creation of the file. 

: label 

This positions a label in a command file. The label is terminated by new-line, and blanks 
between the : and the start of the label are ignored. This command may also be used to insert 
comments into a command file, since labels need not be referenced. 

(.,. )xhlregular expression/label 

A jump (either upward or downward) is made to label if the command succeeds. It fails under 
any of the following conditions: 

1. Either address is not between 1 and $. 

2. The second address is less than the first. 

3. The regular expression doesn’t match at least one line in the specified range, 
including the first and last lines. 

On success,. is set to the line matched and a jump is made to label. This command is the only 
one that doesn’t issue an error message on bad addresses, so it may be used to test whether 
addresses are bad before other commands are executed. Note that the command 


xb/7 label 
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is an unconditional jump. 

The xb command is allowed only if it is read from someplace other than a terminal. If it is 
read from a pipe only a downward jump is possible. 

xt number 

Output from the p and null commands is truncated to at most number characters. The initial 
number is 255. 

x\{digit'\ {spaces'\ {value\ 

The variable name is the specified digit following the xv. xvSlOO or xv5 100 both assign the 
value 100 to the variable 5. Xv61,100p assigns the value l,100p to the variable 6. To refer¬ 
ence a variable, put a % in front of the variable name. For example, using the above assign¬ 
ments for variables 5 and 6: 

l,%5p 

1,%5 

%6 

will all print the first 100 lines. 
g/%5/p 

would globally search for the characters 100 and print each line containing a match. To escape 
the special meaning of %, a \ must precede it. 

g/".^\%[cds]/p 

could be used to match and list lines containing print/ of characters, decimal integers, or 
strings. 

Another feature of the xv command is that the first line of output from a UNIX command can 
be stored into a variable. The only requirement is that the first character of value be an !. For 
example: 

xvSIcat junk 
Irm junk 
lecho "%5" 
xv6!expr %6 +1 

would put the current line into variable 5, print it, and increment the variable 6 by one. To 
escape the special meaning of! as the first character of value, precede it with a \. 

xv7\!date 

stores the value !date into variable 7. 
xbz label 

xbn label 

These two commands will test the last saved return code from the execution of a UNIX com¬ 
mand {\command) or nonzero value, respectively, to the specified label. The two examples 
below both search for the next five lines containing the string size. 

xv55 
: 1 

/size/ 

xv5!expr %5 - 1 
!if0%5 !=0exit2 
xbn 1 
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xv45 
: 1 

/size/ 

xv4!expr %4 - 1 
!if 0%4 = 0 exit 2 
xbz 1 

xc [switch] 

If switch is 1, output from the p and null commands is crunched; if switch is 0 it isn’t. With¬ 
out an argument, xc reverses switch. Initially switch is set for no crunching. Crunched output 
has strings of tabs and blanks reduced to one blank and blank lines suppressed. 

SEE ALSO 

csplit(l), ed(l), regex(3X). 

DIAGNOSTICS 

? for errors in commands, if prompting is turned off. Self-explanatory error messages when prompting is 
on. 
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NAME 

bs - a compiler/interpreter for modest-sized programs 

SYNOPSIS 

bs [ file [ args ] ] 

DESCRIPTION 

Bs is a remote descendant of Basic and Snobol4 with a little C language thrown in. Bs is designed for pro¬ 
gramming tasks where program development time is as important as the resulting speed of execution. For¬ 
malities of data declaration and file/process manipulation are minimized. Line-at-a-time debugging, the 
trace and dump statements, and useful run-time error messages all simplify program testing. Furthermore, 
incomplete programs can be debugged; inner functions can be tested before outer functions have been writ¬ 
ten and vice versa. 

If the command line file argument is provided, the file is used for input before the console is read. By 
default, statements read from the file argument are compiled for later execution. Likewise, statements 
entered from the console are normally executed immediately (see compile and execute below). Unless the 
final operation is assignment, the result of an immediate expression statement is printed. 

Bs programs are made up of input lines. If the last character on a line is a \, the line is continued. Bs 
accepts lines of the following form: 

statement 
label statement 

A label is a name (see below) followed by a colon. A label and a variable can have the same name. 

A bs statement is either an expression or a keyword followed by zero or more expressions. Some keywords 
(clear, compile,!, execute, include, ibase, obase, and run) are always executed as they are compiled. 

Statement Syntax: 

expression 

The expression is executed for its side effects (value, assignment or function call). The details of 
expressions follow the description of statement types below. 

break 

Break exits from the inner-most/or/w/ii/e loop. 

clear 

Clears the symbol table and compiled statements. Clear is executed immediately, 
compile [ expression ] 

Succeeding statements are compiled (overrides the immediate execution default). The optional expres¬ 
sion is evaluated and used as a file name for further input. A clear is associated with this latter case. 
Compile is executed immediately. 

continue 

Continue transfers to the loop-continuation of the cuntni for/while loop. 

dump 

The name and current value of every non-local variable is printed. After an error or interrupt, the num¬ 
ber of the last statement and (possibly) the user-function trace are displayed. 

exit [ expression ] 

Return to system level. The expression is returned as process status, 
execute 

Change to immediate execution mode (an interrupt has a similar effect). This statement does not cause 
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stored statements to execute (see run below). 

for name = expression expression statement 
for name = expression expression 

next 

for expression , expression , expression statement 
for expression , expression , expression 

next 

The/or statement repetitively executes a statement (first form) or a group of statements (second form) 
under control of a named variable. The variable takes on the value of the first expression, then is incre¬ 
mented by one on each loop, not to exceed the value of the second expression. The third and fourth 
forms require three expressions separated by commas. The first of these is the initialization, the second 
is the test (true to continue), and the third is the loop-continuation action (normally an increment). 

funf([a,...])[v,...] 

nuf 

Fun defines the function name, arguments, and local variables for a user-written function. Up to ten 
arguments and local variables are allowed. Such names cannot be arrays, nor can they be I/O associ¬ 
ated. Function definitions may not be nested. 

freturn 

A way to signal the failure of a user-written function. See the interrogation operator (?) below. If inter¬ 
rogation is not present,/r^mm merely returns zero. When interrogation is slcxivq, freturn transfers to 
that expression (possibly by-passing intermediate function returns). 

ibase N 

Ibase sets the input base (radix) to N. The only supported values for N are 8, 10 (the default), and 16. 
Hexadecimal values 10-15 are entered as a-f. A leading digit is required (i.e., fOa must be entered as 
OfOa). Ibase (and abase, below) are executed immediately. 

goto name 

Control is passed to the internally stored statement with the matching label. 

if expression statement 
if expression 

[ else 


fi 

The statement (first form) or group of statements (second form) is executed if the expression evaluates 
to non-zero. The strings 0 and "" (null) evaluate as zero. In the second form, an optional else allows 
for a group of statements to be executed when the first group is not. The only statement permitted on 
the same line with an else is an if\ only other//’s can be on the same line with a fi. The elision of else 
and if into an elif is supported. Only a single fi is required to close an if... elif... [ else ... ] sequence. 

include expression 

The expression must evaluate to a file name. The file must contain bs Such statements become part of 
the program being compiled, source statements. Include statements may not be nested. 

obase N 

Obase sets the input base to N (see ibase above). 

onintr label 
onintr 

The onintr command provides program control of interrupts. In the first form, control will pass to the 
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label given, just as if a goto had been executed at the time onintr was executed. The effect of the state¬ 
ment is cleared after each interrupt. In the second form, an interrupt will cause hs to terminate. 

return [expression] 

The expression is evaluated and the result is passed back as the value of a function call. If no expres¬ 
sion is given, zero is returned. 

run 

The random number generator is reset. Control is passed to the first internal statement. If the run state¬ 
ment is contained in a file, it should be the last statement. 

stop 

Execution of internal statements is stopped. Bs reverts to immediate mode, 
trace [ expression ] 

The trace statement controls function tracing. If the expression is null (or evaluates to zero), tracing is 
turned off. Otherwise, a record of user-function calls/retums will be printed. Each return decrements 
the trace expression value. 

while expression statement 
while expression 

next 

While is similar to for except that only the conditional expression for loop-continuation is given. 

! shell command 

An immediate escape to the Shell. 

#... 

This statement is ignored. It is used to interject commentary in a program. 

Expression Syntax: 
name 

A name is used to specify a variable. Names are composed of a letter (upper or lower case) optionally 
followed by letters and digits. Only the first six characters of a name are significant. Except for names 
declared in fun statements, all names are global to the program. Names can take on numeric (double 
float) values, string values, or can be associated with input/output (see the built-in function open{) 
below). 

name ([expression [, expression] ... ]) 

Eunctions can be called by a name followed by the arguments in parentheses separated by commas. 
Except for built-in functions (listed below), the name must be defined with a/nn statement. Arguments 
to functions are passed by value. 

name [ expression [, expression ]... ] 

This syntax is used reference either arrays or tables (see built-in table functions below). For arrays, 
each expression is truncated to an integer and used as a specifier for the name. The resulting array ref¬ 
erence is syntactically identical to a name; a[l,2] is the same as a[l][2]. The truncated expressions are 
restricted to values between 0 and 32767. 

number 

A number is used to represent a constant value. A number is written in Fortran style, and contains dig¬ 
its, an optional decimal point, and possibly a scale factor consisting of an e followed by a possibly 
signed exponent. 

string 

Character strings are delimited by " characters. The \ escape character allows the double quote (\"), 
new-line (\n), carriage return (\r), backspace (\b), and tab (\t) characters to appear in a string. Other¬ 
wise, \ stands for itself. 
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(expression) 

Parentheses are used to alter the normal order of evaluation. 

(expression, expression [, expression ...])[ expression ] 

The bracketed expression is used as a subscript to select a comma-separated expression from the paren¬ 
thesized list. List elements are numbered from the left, starting at zero. The expression: 

(False, True )[ a == b ] 
has the value True if the comparison is true. 

? expression 

The interrogation operator tests for the success of the expression rather than its value. At the moment, 
it is useful for testing end-of-file (see examples in the Programming Tips section below), the result of 
the eval built-in function, and for checking the return from user-written functions (see /return). An 
interrogation “trap” (end-of-file, etc.) causes an immediate transfer to the most recent interrogation, 
possibly skipping assignment statements or intervening function levels. 

- expression 

The result is the negation of the expression. 

++ name 

Increments the value of the variable (or array reference). The result is the new value. 

— name 

Decrements the value of the variable. The result is the new value. 

! expression 

The logical negation of the expression. Watch out for the shell escape command, 
expression operator expression 

Common functions of two arguments are abbreviated by the two arguments separated by an operator 
denoting the function. Except for the assignment, concatenation, and relational operators, both 
operands are converted to numeric form before the function is applied. 

Binary Operators (in increasing precedence): 


= is the assignment operator. The left operand must be a name or an array element. The result is the 
right operand. Assignment binds right to left, all other operators bind left to right. 


_ (underscore) is the concatenation operator. 

& I 

& (logical and) has result zero if either of its arguments are zero. It has result one if both of its argu¬ 
ments are non-zero; I (logical or) has result zero if both of its arguments are zero. It has result one if 
either of its arguments is non-zero. Both operators treat a null string as a zero. 

<<=>>= == != 

The relational operators (< less than, <= less than or equal, > greater than, >= greater than or equal, == 
equal to, != not equal to) return one if their arguments are in the specified relation. They return zero 
otherwise. Relational operators at the same level extend as follows: a>b>c is the same as a>h & h>c. 
A string comparison is made if both operands are strings. 

+ - 

Add and subtract. 

^ / % 

Multiply, divide, and remainder. 
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Exponentiation. 

Built-in Functions: 

Dealing with arguments 

arg(i) 

is the value of the i-th actual parameter on the current level of function call. At level zero, arg returns 
the i-th. command-line argument (arg(O) returns bs). 

narg() 

returns the number of arguments passed. At level zero, the command argument count is returned. 

Mathematical 

abs(x) 

is the absolute value of j:. 
atan(x) 

is the arctangent of jc. Its value is between -nil and nil. 
ceil(x) 

returns the smallest integer not less than x. 
cos(x) 

is the cosine of (radians). 
exp(x) 

is the exponential function of x. 

floor(x) 

returns the largest integer not greater than x. 
log(x) 

is the natural logarithm of x. 

rand() 

is a uniformly distributed random number between zero and one. 
sin(x) 

is the sine of x (radians). 
sqrt(x) 

is the square root of x. 

String operations 

size(s) 

the size (length in bytes) of s is returned. 
format(f, a) 

returns the formatted value of a. F is assumed to be a format specification in the style of printf(3S). 
Only the % ...f, % ...e, and % ...s types are safe. 

mdex(x, y) 

returns the number of the first position in x that any of the characters from j matches. No match yields 
zero. 

trans(s, f, t) 

Translates characters of the source s from matching characters in/ to a character in the same position in 
t. Source characters that do not appear in / are copied to the result. If the string / is longer than t, 
source characters that match in the excess portion of/do not appear in the result. 

substr(s, start, width) 

returns the sub-string of 5 defined by the starting position and width. 
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match(string, pattern) 
mstring(n) 

The pattern is similar to the regular expression syntax of the ed{\) command. The characters [, ], 
(inside brackets), * and $ are special. The mstring function returns the n-th (1 <= n <= 10) substring of 
the subject that occurred between pairs of the pattern symbols \( and \) for the most recent call to match. 
To succeed, patterns must match the beginning of the string (as if all patterns began with ''). The func¬ 
tion returns the number of characters matched. For example: 

match("al23abl23", ".A([a-z]\y') == 6 
mstring(l) == "b" 

File handling 

open(name, file, function) 
close(name) 

The name argument must be a bs variable name (passed as a string). For the open, the file argument 
may be 1 ) a 0 (zero), 1, or 2 representing standard input, output, or error output, respectively, 2 ) a string 
representing a file name, or 3) a string beginning with an ! representing a command to be executed (via 
sh -c). The function argument must be either r (read), w (write), W (write without new-line), or a 
(append). After a close, the name reverts to being an ordinary variable. The initial associations are: 

open("get", 0, "r") 
openC'put", 1, ”w") 
open("puterr", 2, "w") 

Examples are given in the following section. 

access(s, m) 

executes access{2). 

ftype(s) 

returns a single character file type indication: f for regular file, d for directory, b for block special, or c 
for character special. 

Tables 

table(name, size) 

A table in bs is an associatively accessed, single-dimension array. “Subscripts” (called keys) are 
strings (numbers are converted). The name argument must be a bs variable name (passed as a string). 
The size argument sets the minimum number of elements to be allocated. Bs prints an error message 
and stops on table overflow. 

item(name, i) 

keyO 

The item function accesses table elements sequentially (in normal use, there is no orderly progression of 
key values). Where the item function accesses values, the key function accesses the “subscript” of the 
previous item call. The name argument should not be quoted. Since exact table sizes are not defined, 
the interrogation operator should be used to detect end-of-table, for example: 

tableC't", 100) 

# If word contains "party", the following expression adds one to the count 

# of that word: 

++t[word] 

# To print out the the key/value pairs: 

for i = 0, ?(s = item(t, i)), -t’+i if key() put = key()_":"_s 

iskey(naine, word) 

The iskey function tests whether the key word exists in the table name and returns one for true, zero for 
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false. 


Odds and ends 


eval(s) 

The string argument is evaluated as a bs expression. The function is handy for converting numeric 
strings to numeric internal form. Eval can also be used as a crude form of indirection, as in: 

name = "xyz" 
eval("++"_ name) 

which increments the variable xyz- In addition, eval preceded by the interrogation operator permits the 
user to control hs error conditions. For example: 

?eval("open(\"X\", \"XXX\'’, \'’r\'’)") 

returns the value zero if there is no file named “XXX” (instead of halting the user’s program). The fol¬ 
lowing executes a goto to the label L (if it exists): 


if !(?eval("goto label)) puterr = "no label" 

plot(request, args) 

The plot function produces output on devices recognized by tplot{\G). The requests are as follows: 


Call Function 

plot(0, term) 

causes further plot output to be piped into tplot{\G) with an 
argument of -Tterm. 

plot(l) 

“erases” the plotter. 

plot(2, string) 

labels the current point with string. 

plot(3, xl,yl,x2, y2) 

draws the line between (xl,yl) and {x2,y2). 

plot(4, X, y, r) 

draws a circle with center (jc,y) and radius r. 

plot(5, xl,yl,x2, y2, x3, y3) 

draws an arc (counterclockwise) with center (xl,yl) and end¬ 
points (x2,y2) and (x3,y3). 

plot(6) 

is not implemented. 

plot(7, X, y) 

makes the current point (jc,y). 

plot(8, X, y) 

draws a line from the current point to (A:,y). 

plot(9, X, y) 

draws a point at (j:,y). 

plot(10, string) 

sets the line mode to string . 

plot(ll,xl,yl,x2, y2) 

makes (xl,yl) the lower left corner of the plotting area and 
(x2 ,y2) the upper right corner of the plotting area. 

plot(12, xl, yl, x2, y2) 

causes subsequent x (y) coordinates to be multiplied by xl (yl) 
and then added to x2 iy2) before they are plotted. The initial 
scaling is plot(12,1.0,1.0,0.0, 0.0). 


Some requests do not apply to all plotters. All requests except zero and twelve are implemented by pip¬ 
ing characters to tplotOG). See plot(5) for more details. 

Iast() 

in immediate mode, last returns the most recently computed value. 

PROGRAMMING TIPS 

Using bs as a calculator: 

$ bs 

# Distance (inches) light travels in a nanosecond. 
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186000*5280* 12/le9 

11.78496 


# Compound interest (6% for 5 years on $1,000). 
int = .06 / 4 

bal= 1000 

for i = 1 5*4 bal = bal + bal*int 

bal - 1000 

346.855007 

exit 

The outline of a typical bs program: 

# initialize things: 
varl = 1 

open("read", "infile", "r") 

# compute: 
while ?(str = read) 

next 

# clean up: 
closeC'read") 

# last statement executed (exit or stop): 
exit 

# last input line: 
run 

Input/Output examples: 

# Copy "oldfile" to "newfile". 
openC'read", "oldfile", "r") 
open("write", "newfile”, "w") 

while ?(write = read) 

# close "read" and "write": 
closeC'read") 
close("write”) 

# Pipe between commands. 
open("ls", "!ls *", "r") 
open("pr", "!pr-2-h'List'", "w") 
while ?(pr = Is) ... 

# be sure to close (wait for) these: 
close("ls") 

close("pr") 

SEE ALSO 

ed(l), sh(l), tplot(lG), access(2), printf(3S), stdio(3S), Section 3 of this volume for further description of 
the mathematical functions (pow(3M) is used for exponentiation), plot(5). Bs uses the Standard 
Input/Output package. 
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NAME 

cal - print calendar 

SYNOPSIS 

cal [ month ] year 

DESCRIPTION 

Cal prints a calendar for the specified year. If a month is also specified, a calendar just for that month is 
printed. Year can be between 1 and 9999. The month is a number between 1 and 12. The calendar pro¬ 
duced is that for England and her colonies. 

Try September 1752. 

BUGS 

The year is always considered to start in January even though this is historically naive. 

Beware that “cal 78“ refers to the early Christian era, not the 20th century. 
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NAME 

calendar - reminder service 

SYNOPSIS 

calendar [ - ] 

DESCRIPTION 

Calendar consults the file calendar in the current directory and prints out lines that contain today’s or 
tomorrow’s date anywhere in the line. Most reasonable month-day dates such as “Dec. 7,” “december?,’’ 
“12/7,” etc., are recognized, but not “7 December’ or “7/12”. On weekends “tomorrow’’ extends 
through Monday. 

When an argument is present, calendar does its job for every user who has a file calendar in his login 
directory and sends him any positive results by mail{l). Normally this is done daily in the wee hours under 
control of cron(lM). 

FILES 

calendar 

/usr/lib/calprog to figure out today’s and tomorrow’s dates 

/etc/passwd 

/tmp/cal* 

/usr/lib/crontab 

SEE ALSO 

cron(lM), mail(l). 

BUGS 

Your calendar must be public information for you to get reminder service. 

Calendar’s extended idea of ‘ ‘tomorrow’ ’ does not account for holidays. 
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NAME 

cat - concatenate and print files 
SYNOPSIS 

cat [ -u ] [ -s ] file ... 

DESCRIPTION 

Cat reads each file in sequence and writes it on the standard output. Thus: 
cat file 

prints the file, and: 

cat filel file2 >file3 

concatenates the first two files and places the result on the third. 

If no input file is given, or if the argument - is encountered, cat reads from the standard input file. Output 
is buffered in 512-byte blocks unless the -u option is specified. The -s option makes cat silent about non¬ 
existent files. No input file may be the same as the output file unless it is a special file. 

SEE ALSO 

cp(l),pr(l). 
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NAME 

cb - C program beautifier 

SYNOPSIS 

cb [file] 

DESCRIPTION 

Cb places a copy of the C program in file (standard input if file is not given) on the standard output with 
spacing and indentation that displays the structure of the program. 
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NAME 

cc, pcc - C compiler 

SYNOPSIS 

cc [ option ] ... file ... 
pcc [ option ] ... file ... 

DESCRIPTION 

Cc is the UNIX C compiler. Pcc is the portable version for a PDP-11 machine. They accept several types 
of arguments: 

Arguments whose names end with .c are taken to be C source programs; they are compiled, and each object 
program is left on the file whose name is that of the source with .o substituted for .c. The .o file is normally 
deleted, however, if a single C program is compiled and loaded all at one go. 

In the same way, arguments whose names end with .s are taken to be assembly source programs and are 
assembled, producing a .o file. 

The following options are interpreted by cc and pcc. See ld{l) for link editor options. 

-c Suppress the link edit phase of the compilation, and force an object file to be produced even if 

only one program is compiled. 

-p Arrange for the compiler to produce code which counts the number of times each routine is 
called; also, if link editing takes place, replace the standard startoff routine by one which auto¬ 
matically calls monitor(3C) at the start and arranges to write out a mon.out file at normal termi¬ 
nation of execution of the object program. An execution profile can then be generated by use of 
prof(l). 

-f Link the object program with the floating-point interpreter for systems without hardware 

floating-point. 

-g Cause the compiler to generate additional information needed for the use of sdh(l). (VAX- 
11/780 only.) 

-dn This option is passed through to fl^(l). (VAX only.) 

-O Invoke an object-code optimizer. 

-S Compile the named C programs, and leave the assembler-language output on corresponding files 
suffixed .s. 

-E Run only the macro preprocessor on the named C programs, and send the result to the standard 
output. 

-P Run only the macro preprocessor on the named C programs, and leave the result on correspond¬ 
ing files suffixed .1. 

-C Comments are not stripped by the macro preprocessor. 

-Dname=def 

-Dname Define the name to the preprocessor, as if by #deflne. If no definition is given, the name is 
defined as 1. 

-Vname Remove any initial definition of name. 

-\dir Change the algorithm for searching for #include files whose names do not begin with / to look in 
dir before looking in the directories on the standard list. Thus, #include files whose names are 
enclosed in " " will be searched for first in the directory of the file argument, then in directories 
named in -I options, and last in directories on a standard list. For #mclude files whose names are 
enclosed in <>, the directory of the file argument is not searched. 

-Bstring Find substitute compiler passes in the files named string with the suffixes cpp, cO, cl and c2. If 
string is empty, use a standard backup version. 
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-t[p012] Find only the designated compiler passes in the files whose names are constructed by a -B 
option. In the absence of a -B option, the string is taken to be /lib/n. 

Other arguments are taken to be either link editor option arguments, or C-compatible object programs, typi¬ 
cally produced by an earlier cc or pcc run, or perhaps libraries of C-compatible routines. These programs, 
together with the results of any compilations specified, are linked (in the order given) to produce an exe¬ 
cutable program with the name a.out. 

FILES 


file.c 

input file 

file.o 

object file 

a.out 

linked output 

/tmp/ctm* 

temporary 

/lib/cpp 

preprocessor 

/lib/c[01] 

PDP-11 compiler, cc 

/usr/lib/comp 

compiler, pcc 

/lib/ccom 

VAX compiler, cc 

/lib/c2 

optional optimizer 

/lib/oc* 

backup compiler, occ 

/lib/nc* 

test compiler, ncc 

/lib/fcl 

PDP-11 floating-point compiler, cc 

/lib/crtO.o 

runtime startoff 

/lib/mcrtO.o 

startoff for profiling 

/lib/fcrtO.o 

startoff for floating-point interpretation 

/lib/libc.a 

standard library, see (3) 

/usr/include 

standard directory for #mclude files 


SEE ALSO 

B. W. Kernighan and D. M. Ritchie, The C Programming Language, Prentice-Hall, 1978. 

B. W. Kernighan, Programming in C-A Tutorial. 

D. M. Ritchie, C Reference Manual. 
adb(l), as(l), ld(l), prof(l), monitor(3C). 

DIAGNOSTICS 

The diagnostics produced by C itself are intended to be self-explanatory. Occasional messages may be pro¬ 
duced by the assembler or the link editor. Of these, the most mystifying are from the PDP-11 assembler, in 
particular m, which means a multiply-defined external symbol (function or data). 
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NAME 

cd - change working directory 

SYNOPSIS 

cd [ directory ] 

DESCRIPTION 

If specified, directory becomes the new working directory; otherwise, the value of the shell parameter 
$HOME is used. The process must have execute (search) permission in directory. 

Because a new process is created to execute each command, cd would be ineffective if it were written as a 
normal command; therefore, it is recognized and executed by the shell. 

SEE ALSO 

pwd(l), sh(l), chdir(2). 
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NAME 

cdc - change the delta commentary of an SCCS delta 
SYNOPSIS 

cdc -rSID [-mfmrlist]] [-y[comment]] files 
DESCRIPTION 

Cdc changes the delta commentary, for the SID specified by the -r keyletter, of each named SCCS file. 

Delta commentary is defined to be the Modification Request (MR) and comment information normally 
specified via the delta{\) command (-m and -y keyletters). 

If a directory is named, cdc behaves as though each file in the directory were specified as a named file, 
except that non-SCCS files (last component of the path name does not begin with s.) and unreadable files 
are silently ignored. If a name of - is given, the standard input is read (see WARNINGS)', each line of the 
standard input is taken to be the name of an SCCS file to be processed. 

Arguments to cdc, which may appear in any order, consist of keyletter arguments, and file names. 

All the described keyletter arguments apply independently to each named file: 

-rSID Used to specify the 5CCS /Dentification (SID) string of a delta for which the delta 

commentary is to be changed. 

-m[mrlist] If the SCCS file has the v flag set (see admin(\)) then a list of MR numbers to be 

added and/or deleted in the delta commentary of the SID specified by the -r keylet¬ 
ter may be supplied. A null MR list has no effect. 

MR entries are added to the list of MRs in the same manner as that of delta(l). In 
order to delete an MR, precede the MR number with the character ! (see EXAM¬ 
PLES). If the MR to be deleted is currently in the list of MRs, it is removed and 
changed into a “comment” line. A list of all deleted MRs is placed in the com¬ 
ment section of the delta commentary and preceded by a comment line stating that 
they were deleted. 

If -m is not used and the standard input is a terminal, the prompt MRs? is issued 
on the standard output before the standard input is read; if the standard input is not 
a terminal, no prompt is issued. The MRs? prompt always precedes the com¬ 
ments? prompt (see -y keyletter). 

MRs in a list are separated by blanks and/or tab characters. An unescaped new- 
line character terminates the MR list. 

Note that if the v flag has a value (see admin{\)), it is taken to be the name of a 
program (or shell procedure) which validates the correctness of the MR numbers. 
If a non-zero exit status is returned from the MR number validation program, cdc 
terminates and the delta commentary remains unchanged. 

-y{comment] Arbitrary text used to replace the comment{^) already existing for the delta 
specified by the -r keyletter. The previous comments are kept and preceded by a 
comment line stating that they were changed. A null comment has no effect. 

If -y is not specified and the standard input is a terminal, the prompt comments? 
is issued on the standard output before the standard input is read; if the standard 
input is not a terminal, no prompt is issued. An unescaped new-line character ter¬ 
minates the comment text. 

The exact permissions necessary to modify the SCCS file are documented in the Source Code Control 
System User’s Guide. Simply stated, they are either (1) if you made the delta, you can change its 
delta commentary; or (2) if you own the file and directory you can modify the delta commentary. 

EXAMPLES 

cdc -rL6 -m'’bl78-12345 !bl77-54321 bl79-00001" -ytrouble s.file 
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adds bl78-12345 and bl79-00001 to the MR list, removes bl77-54321 from the MR list, and adds the com¬ 
ment trouble to delta 1.6 of s.file. 

cdc -rL6 s.file 

MRS? !bl77-54321 bl78-12345 bl79-00001 
comments? trouble 

does the same thing. 

WARNINGS 

If sees file names are supplied to the cdc command via the standard input (- on the command line), then 
the -m and -y keyletters must also be used. 

FILES 

x-file (see delta{\)) 

z-file (see delta{\)) 

SEE ALSO 

admin(l), delta(l), get(l), help(l), prs(l), sccsfile(5). 

Source Code Control System User’s Guide by L. E. Bonanni and C. A. Salemi. 

DIAGNOSTICS 

Use help{\.) for explanations. 
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NAME 

chmod - change mode 

SYNOPSIS 

chmod mode file... 

DESCRIPTION 

The permissions of each named file are changed according to mode, which may be absolute or symbolic. 
An absolute mode is an octal number constructed from the OR of the following modes: 

4000 set user ID on execution 
2000 set group ID on execution 

1000 sticky bit, see chmod{2) 

0400 read by owner 

0200 write by owner 

0100 execute (search in directory) by owner 

0070 read, write, execute (search) by group 

0007 read, write, execute (search) by others 

A symbolic mode has the form: 

[who] op permission [ op permission ] 

The who part is a combination of the letters u (for user’s permissions), g (group) and o (other). The letter a 
stands for ugo, the default if who is omitted. 

Op can be + to add permission to the file’s mode, - to take away permission, or = to assign permission 
absolutely (all other bits will be reset). 

Permission is any combination of the letters r (read), w (write), x (execute), s (set owner or group ID) and t 
(save text - sticky); u, g or o indicate that permission is to be taken from the current mode. Omitting 
permission is only useful with = to take away all permissions. 

Multiple symbolic modes separated by commas may be given. Operations are performed in the order 
specified. The letter s is only useful with u or g and t only works with u. 

Only the owner of a file (or the super-user) may change its mode. 

EXAMPLES 

The first example denies write permission to others, the second makes a file executable: 
chmod o-w file 

chmod +X file 

SEE ALSO 

ls(l), chmod(2). 
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NAME 

chown, chgrp - change owner or group 

SYNOPSIS 

chown owner file... 

chgrp group file... 

DESCRIPTION 

Chown changes the owner of the files to owner. The owner may be either a decimal user ID or a login 
name found in the password file. 

Chgrp changes the group ID of the files to group. The group may be either a decimal group ID or a group 
name found in the group file. 

FILES 

/etc/passwd 

/etc/group 

SEE ALSO 

chown(2), group(5), passwd(5). 
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NAME 

chroot - change root directory for a command 
SYNOPSIS 

chroot newroot command 
DESCRIPTION 

The given command is executed relative to the new root. The meaning of any initial slashes (/) in path 
names is changed for a command and any of its children to newroot. Furthermore, the initial working 
directory is newroot. 

Notice that: 

chroot newroot command >x 

will create the file x relative to the original root, not the new one. 

This command is restricted to the super-user. 

The new root path name is always relative to the current root: even if a chroot is currently in effect, the 
newroot argument is relative to the current root of the running process. 

SEE ALSO 

chdir(2). 

BUGS 

One should exercise extreme caution when referencing special files in the new root file system. 
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NAME 

clri - clear i-node 
SYNOPSIS 

clri file-system i-number... 

DESCRIPTION 

Clri writes zeros on the 64 bytes occupied by the i-node numbered i-number. File-system must be a special 
file name referring to a device containing a file system. After clri is executed, any blocks in the affected 
file will show up as “missing” in an/s'c^(lM) of ihQ file-system. This command should only be used in 
emergencies and extreme care should be exercised. 

Read and write permission is required on the specified file-system device. The i-node becomes allocatable. 

The primary purpose of this routine is to remove a file which for some reason appears in no directory. If it 
is used to zap an i-node which does appear in a directory, care should be taken to track down the entry and 
remove it. Otherwise, when the i-node is reallocated to some new file, the old entry will still point to that 
file. At that point removing the old entry will destroy the new file. The new entry will again point to an 
unallocated i-node, so the whole cycle is likely to be repeated again and again. 

SEE ALSO 

fsck(lM), fsdb(lM), ncheck(lM), fs(5). 

BUGS 

If the file is open, clri is likely to be ineffective. 



CMP(l) 


CMP(l) 


NAME 

cmp - compare two files 
SYNOPSIS 

cmp [ -I ] [ -s ] filel file2 
DESCRIPTION 

The two files are compared. (\ifilel is the standard input is used.) Under default options, cmp makes no 
comment if the files are the same; if they differ, it announces the byte and line number at which the differ¬ 
ence occurred. If one file is an initial subsequence of the other, that fact is noted. 

Options: 

-I Print the byte number (decimal) and the differing bytes (octal) for each difference. 

-s Print nothing for differing files; return codes only. 

SEE ALSO 

comm(l), diff(l). 

DIAGNOSTICS 

Exit code 0 is returned for identical files, 1 for different files, and 2 for an inaccessible or missing argument. 
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NAME 

col - filter reverse line-feeds 

SYNOPSIS 

col [ -bfpx ] 

DESCRIPTION 

Col reads from the standard input and writes onto the standard output. It performs the line overlays implied 
by reverse line feeds (ASCII code ESC-7), and by forward and reverse half-line-feeds (ESC-9 and ESC-8). 
Col is particularly useful for filtering multicolumn output made with the rt command of nrojf{l) and out¬ 
put resulting from use of the tbl{\) preprocessor. 

If the -b option is given, col assumes that the output device in use is not capable of backspacing. In this 
case, if two or more characters are to appear in the same place, only the last one read will be output. 

Although col accepts half-line motions in its input, it normally does not emit them on output. Instead, text 
that would appear between lines is moved to the next lower full-line boundary. This treatment can be sup¬ 
pressed by the -f (fine) option; in this case, the output from col may contain forward half-line-feeds (ESC- 
9), but will still never contain either kind of reverse line motion. 

Unless the -x option is given, col will convert white space to tabs on output wherever possible to shorten 
printing time. 

The ASCII control characters SO (\017) and SI (\016) are assumed by col to start and end text in an alternate 
character set. The character set to which each input character belongs is remembered, and on output SI and 
SO characters are generated as appropriate to ensure that each character is printed in the correct character 
set. 

On input, the only control characters accepted are space, backspace, tab, return, new-line, SI, SO, VT 
(\013), and ESC followed by 7, 8, or 9. The VT character is an alternate form of full reverse line-feed, 
included for compatibility with some earlier programs of this type. All other non-printing characters are 
ignored. 

Normally, col will ignore any unknown to it escape sequences found in its input; the -p option may be used 
to cause col to output these sequences as regular characters, subject to overprinting from reverse line 
motions. The use of this option is highly discouraged unless the user is fully aware of the textual position 
of the escape sequences. 

SEE ALSO 

nroff(l),tbl(l). 

NOTES 

The input format accepted by col matches the output produced by nrojf{\) with either the -T37 or -Tip 
options. Use -T37 (and the -f option of col) if the ultimate disposition of the output of col will be a device 
that can interpret half-line motions, and -Tip otherwise. 

BUGS 

Cannot back up more than 128 lines. 

Allows at most 800 characters, including backspaces, on a line. 

Local vertical motions that would result in backing up over the first line of the document are ignored. As a 
result, the first line must not have any superscripts. 
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NAME 

comb - combine SCCS deltas 
SYNOPSIS 

comb [-o] [-s] [-psid] [-clist] files 
DESCRIPTION 

Comb generates a shell procedure (see sh(\)) which, when run, will reconstruct the given SCCS files. The 
reconstructed files will, hopefully, be smaller than the original files. The arguments may be specified in any 
order, but all keyletter arguments apply to all named SCCS files. If a directory is named, comb behaves as 
though each file in the directory were specified as a named file, except that non-SCCS files (last component 
of the path name does not begin with s.) and unreadable files are silently ignored. If a name of - is given, 
the standard input is read; each line of the standard input is taken to be the name of an SCCS file to be pro¬ 
cessed; non-SCCS files and unreadable files are silently ignored. 

The generated shell procedure is written on the standard output. 

The keyletter arguments are as follows. Each is explained as though only one named file is to be processed, 
but the effects of any keyletter argument apply independently to each named file. 

-pSlD The 5CCS /Dentification string (SID) of the oldest delta to be preserved. All older deltas are dis¬ 
carded in the reconstructed file. 

-clist A list (see get{\) for the syntax of a list) of deltas to be preserved. All other deltas are discarded. 

-o For each get -e generated, this argument causes the reconstructed file to be accessed at the release 

of the delta to be created, otherwise the reconstructed file would be accessed at the most recent 
ancestor. Use of the -o keyletter may decrease the size of the reconstructed SCCS file. It may 
also alter the shape of the delta tree of the original file. 

-s This argument causes comb to generate a shell procedure which, when run, will produce a report 

giving, for each file: the file name, size (in blocks) after combining, original size (also in blocks), 
and percentage change computed by: 

100 * (original - combined) / original 

It is recommended that before any SCCS files are actually combined, one should use this option 
to determine exactly how much space is saved by the combining process. 

If no keyletter arguments are specified, comb will preserve only leaf deltas and the minimal number of 
ancestors needed to preserve the tree. 

FILES 

s.COMB The name of the reconstructed SCCS file, 

comb????? Temporary. 

SEE ALSO 

admin(l), delta(l), get(l), help(l), prs(l), sccsfile(5). 

Source Code Control System User’s Guide by L. E. Bonanni and C. A. Salemi. 

DIAGNOSTICS 

Use helpil) for explanations. 

BUGS 

Comb may rearrange the shape of the tree of deltas. It may not save any space; in fact, it is possible for the 
reconstructed file to actually be larger than the original. 
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NAME 

comm - select or reject lines common to two sorted files 
SYNOPSIS 

comm [-[123]] filelfile2 
DESCRIPTION 

Comm reads file! and file!, which should be ordered in ASCII collating sequence (see 5orr(l)), and pro¬ 
duces a three-column output: lines only 'mfilel ; lines only in file!-, and lines in both files. The file name - 
means the standard input. 

Flags 1, 2, or 3 suppress printing of the corresponding column. Thus comm -12 prints only the lines com¬ 
mon to the two files; comm -23 prints only lines in the first file but not in the second; comm -123 is a no- 
op. 

SEE ALSO 

cmp(l), diff(l), sort(l), uniq(l). 
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NAME 

config - configure a UNIX system 
SYNOPSIS 

/etc/config [ -t ] [ -1 file ] [ -c file ] [ -ni file ] dfile 
DESCRIPTION 

Config is a program that takes a description of a UNIX system and generates two files. One file provides 
information regarding the interface between the hardware and device handlers. The other file is a C pro¬ 
gram defining the configuration tables for the various devices on the system. 

The -1 option specifies the name of the hardware interface file; low.s is the default name on the PDP-11; 
uiiivec.c is the default name on the VAX-11/780. 

The -c option specifies the name of the configuration table file; conf.c is the default name. 

The -m option specifies the name of the file that contains all the information regarding supported devices; 
/etc/master is the default name. This file is supplied with the UNIX system and should not be modified 
unless the usqt fully understands its construction. 

The -t option requests a short table of major device numbers for character and block type devices. This can 
facilitate the creation of special files. 

The user must supply dfile; it must contain device information for the user’s system. This file is divided 
into two parts. The first part contains physical device specifications. The second part contains system- 
dependent information. Any line with an asterisk (*) in column 1 is a comment. 

All configurations are assumed to have the following devices: 

one DLl 1 (for the system console) 

one KWl 1-L line clock or KWl 1-P programmable clock 

with standard interrupt vectors and addresses. These two devices must not be specified in dfile. Note that 
UNIX needs only one clock, but can handle both types. 

First Part of dfile 

Each line contains four or five fields, delimited by blanks and/or tabs in the following format: 
devname vector address bus number 

where devname is the name of the device (as it appears in the /etc/master device table), vector is the inter¬ 
rupt vector location (octal), address is the device address (octal), bus is the bus request level (4 through 7), 
and number is the number (decimal) of devices associated with the corresponding controller; number is 
optional, and if omitted, a default value which is the maximum value for that controller is used. 

There are certain drivers that may be provided with the system, that are actually pseudo-device drivers; that 
is, there is no real hardware associated with the driver. Drivers of this type are identified on their respective 
manual entries. When these devices are specified in the description file, the interrupt vector, device 
address, and bus request level must all be zero. 

Second Part of dfile 

The second part contains three different types of lines. Note that all specifications of this part are required, 
although their order is arbitrary. 

1. Root/pipe/dump device specification 
Three lines of three fields each: 

root devname minor 

pipe devname minor 

dump devname minor 

where minor is the minor device number (in octal). 
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2. Swap device specification 

One line that contains five fields as follows: 

swap devname minor swplo nswap 

where swplo is the lowest disk block (decimal) in the swap area and nswap is the number of disk blocks 
(decimal) in the swap area. 

3. Parameter specification 

Thirteen lines of two fields each as follows {number is decimal): 


buffers 

number 

sabufs 

number 

inodes 

number 

files 

number 

mounts 

number 

coremap 

number 

swapmap 

number 

calls 

number 

procs 

number 

maxproc 

number 

texts 

number 

clists 

number 

power 

Oor 1 


(not on the VAX-11/780) 


(not on the VAX-11/780) 


EXAMPLE 

Suppose we wish to configure a PDP-11/70 system with the following devices: 
one RP04 disk drive controller with 6 drives 
one DHl 1 asynchronous multiplexer with 16 lines (default number) 
one DMl 1 modem control with 16 lines (for the DHl 1) 
one DHl 1 asynchronous multiplexer with 8 lines 
one DMl 1 modem control with 8 lines (for the DHl 1) 
one LPl 1 line printer 

one TUI6 tape drive controller with 2 drives 
one DLll asynchronous interface 

Note that UNIX only supports DHl 1 units that require corresponding DMl 1 units. It is wise to specify them 
in DH-DM pairs to facilitate understanding the configuration. Note also that, in the preceding case, the 
DLll that is specified is in addition to the DLll that was part of the initial system. We must also specify 
the following parameter information: 

root device is an RP04 (drive 0, section 0) 
pipe device is an RP04 (drive 0, section 0) 
swap device is an RP04 (drive 1, section 4), 
with a swplo of 6000 and an nswap of 2000 
dump device is aTU16 (drive 0) 
number of buffers is 35 
number of system addressable buffers is 12 
number of processes is 150 
maximum number of processes per user ID is 25 
number of mounts is 8 
number of inodes is 120 
number of files is 120 
number of calls is 30 
number of texts is 35 
number of character buffers is 150 
number of coremap entries is 50 
number of swapmap entries is 50 
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power fail recovery is to be included 
The actual system configuration would be specified as follows: 


rp04 

254 

776700 

5 

6 

dhll 

320 

760020 

5 


dmll 

300 

770500 

4 


dhll 

330 

760040 

5 

8 

dmll 

304 

770510 

4 

8 

Ipll 

200 

775514 

5 


tul6 

224 

772440 

5 

2 

dill 

350 

775610 

5 


root 

rp04 

0 



pipe 

rp04 

0 



swap 

rp04 

14 

6000 

2000 

dump 

tul6 

0 




* Comments may be inserted in this manner 
buffers 35 

sabufs 12 

procs 150 

maxproc 25 

mounts 8 

inodes 120 

files 120 

calls 30 

texts 35 

clists 150 

coremap 50 

swapmap 50 

power 1 

FILES 

/etc/master 
low.s 
univec.c 
conf.c 

SEE ALSO 

master(5). 

Setting Up UNIX. 

DIAGNOSTICS 

Diagnostics are routed to the standard output and are self-explanatory. 


default input master device table 
default output hardware interface file for PDP-11 
default output hardware interface file for the VAX-11/780 
default output configuration table file 


BUGS 

The -t option does not know about devices that have aliases. For example, an RP06 (an alias for an RP04) 
will show up as an RP04; however, the major device numbers are always correct. 
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NAME 

cp, In, mv - copy, link or move files 
SYNOPSIS 

cp filel [ file2 ...] target 
In filel [ file2 ...] target 
mv filel [ file2 ...] target 

DESCRIPTION 

Filel is copied (linked, moved) to target. Under no circumstance can filel and target be the same. If 
target is a directory, then one or more files are copied (linked, moved) to that directory. 

If mv determines that the mode of target forbids writing, it will print the mode (see chmod(2)) and read the 
standard input for one line (if the standard input is a terminal); if the line begins with y, the move takes 
place; if not, mv exits. 

Only mv will allow filel to be a directory, in which case the directory rename will occur only if the two 
directories have the same parent. 

SEE ALSO 

cpio(l), link(lM), rm(l), chmod(2). 

BUGS 

If filel and target lie on different file systems, mv must copy the file and delete the original. In this case 
the owner name becomes that of the copying process and any linking relationship with other files is lost. 

Ln will not link across file systems. 
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NAME 

cpio - copy file archives in and out 

SYNOPSIS 

cpio -o [ acBv ] 

cpio -i [ Bcdmrtuv6 ] [ patterns ] 
cpio -p [ adlmruv ] directory 
DESCRIPTION 

Cpio -o (copy out) reads the standard input to obtain a list of path names and copies those files onto the 
standard output together with path name and status information. 

Cpio -i (copy in) extracts from the standard input (which is assumed to be the product of a previous cpio 
-o) the names of files selected by zero or more patterns given in the name-generating notation of sh(\). In 
patterns, meta-characters ?, *, and [...] match the slash / character. The default for patterns is * (i.e., 
select all files). 

Cpio -p (pass) copies out and in in a single operation. Destination path names are interpreted relative to 
the named directory. 

The meanings of the available options are: 

a Reset access times of input files after they have been copied. 

B Input/output is to be blocked 5,120 bytes to the record (does not apply to the pass option; mean¬ 
ingful only with data directed to or from /dev/rmt?). 
d Directories are to be created as needed. 

c Write header information in ASCII character form for portability, 

r Interactively rename files. If the user types a null line, the file is skipped, 

t Print a table of contents of the input. No files are created. 

u Copy unconditionally (normally, an older file will not replace a newer file with the same name). 

V Verbose: causes a list of file names to be printed. When used with the t option, the table of con¬ 

tents looks like the output of an Is -I command (see ls(].)). 

1 Whenever possible, link files rather than copying them. Usable only with the -p option, 

m Retain previous file modification time. This option is ineffective on directories that are being 
copied. 

6 Process an old (i.e., UNIX Sixth Edition format) file. Only useful with -i (copy in). 

EXAMPLES 

The first example below copies the contents of a directory into an archive; the second duplicates a directory 
hierarchy: 

Is I cpio -o >/dev/mt0 
cd olddir 

find . -print I cpio -pdl newdir 

The trivial case “find . -print I cpio -oB >/dev/rmt0’’ can be handled more efficiently by: 
find . -cpio /dev/rmtO 

SEE ALSO 

ar(l), find(l), cpio(5). 

BUGS 

Path names are restricted to 128 characters. If there are too many unique linked files, the program runs out 
of memory to keep track of them and, thereafter, linking information is lost. Only the super-user can copy 
special files. 
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NAME 

crash - examine system images 
SYNOPSIS 

/etc/crash [ system ] [ namelist ] [ ka6 ] 

DESCRIPTION 

Crash is an interactive utility for examining an operating system core image. It has facilities for interpret¬ 
ing and formating the various control structures in the system and certain miscellaneous functions that are 
useful when perusing a dump. 

The arguments to crash are the file name where the system image can be found, a namelist file to be used 
for symbol values, and the segment address of the initial process to be examined. The current process can 
be changed via subsequent commands. The default values are /dev/mem, /unix, and the location of the 
swapper, process 0; hence, crash with no arguments can be used to examine an active system. If a system 
image file is given, it is assumed to be a system core dump and the initial process is set to be that of the pro¬ 
cess running at the time of the crash. This is determined by the value of ka6 stored in a fixed location by 
the system dump mechanism. 

COMMANDS 

Input to crash is typically of the form: 

command [ options ] [ structures to be printed ]. 

When allowed, options will modify the format of the print out. If no specific structure elements are 
specified, all valid entries will be used. As an example, proc - 12 15 3 would print process table slots 12, 
15 and 3 in a long format, while proc would print the entire process table in the standard format. The cur¬ 
rent repertory consists of: 

ka6 [ segment address ] 

Print the location of the current process if no argument is given, or set the location to that of the 
supplied value. 

u Print the user structure of the current process as determined by the value of ka6. 

trace[-r] 

Generate a kernel stack trace of the current process. If the -r option is used, the trace begins at the 
saved stack frame pointer in r5. Otherwise the trace starts at the bottom of the stack and attempts 
to find valid stack frames deeper in the stack. 

r5 [ stack frame ] 

Print the program’s idea of the start of the current stack frame (set initially from a fixed location in 
the dump) if no argument is given, or set the frame pointer to the supplied value. 

stack Format an octal dump of the kernel stack of the current process. The addresses shown are virtual 
system data addresses rather than true physical locations. 

proc [ -[r] ] [ list of process table entries ] 

Format the process table. The -r option causes only runnable processes to be printed. The - alone 
generates a longer listing. 

inode [ - ] [ list of inode table entries ] 

Format the inode table. The - option will also print the inode data block addresses. 

file [ list of file table entries ] 

Format the file table. 

mount [ list of mount table entries ] 

Format the mount table. 

text [ list of text table entries ] 

Format the text table. 
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tty [ type ] [ - ] [ list of tty entries ] 

Print the tty structures. The type argument determines which structure will be used (such as kl or 
dh; the last type is remembered). The - option prints the stty parameters for the given line. 

stat Print certain statistics found in the dump. These include the panic string, time of crash, system 
name, and the registers saved in low memory by the dump mechanism. 

var Print the tunable system parameters. 

buf [ list of buffer headers ] 

Format the system buffer headers. 

buffer [ format ] [ list of buffers ] 

Print the data in a system buffer according to format. Valid formats include decimal, octal, 
character, byte, directory, inode, and write. The last creates a file containing the buffer data. 

callout Print all entries in the callout table. 

map [ list of map names ] 

Format the named system map structures. 

nm [ list of symbols ] 

Print symbol value and type as found in the namelist file, 
ts [ list of text addresses ] 

Find the closest text symbols to the given addresses. 

ds [ list of data addresses ] 

Find the closest data symbols to the given addresses. 

od [ symbol or data address ] [ count ] [ format ] 

Dump count data values starting at the symbol value or address given according to format. 
Allowable formats are octal, decimal, character, or byte. 

! Escape to shell, 

q Exit from era j'/t. 

? Print synopsis of commands. 

ALIASES 

There are built in aliases for many of the commands and formats. In general, the first letter of a name is sat¬ 
isfactory, thus, k is a shorthand notation for kernel. Exceptions are x for text and e for decimal. 

FILES 

/dev/mem default system image file 

/unix default namelist file 

buf.# files created containing buffer data 

SEE ALSO 

crash(8). 
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NAME 

cref- make cross-reference listing 
SYNOPSIS 

cref [ -acilnostuxl23 ] files 
DESCRIPTION 

Cref makes a cross-reference listing of assembler or C programs; files are searched for symbols in the 
appropriate syntax. 

The output report is in four columns: 

1. symbol; 

2. file name; 

3. see below; 

4. text as it appears in the file. 

Cref uses either an ignore file or an only file. If the -i option is given, the next argument is taken to be an 
ignore file; if the -o option is given, the next argument is taken to be an only file. Ignore and only files are 
lists of symbols separated by new-lines. All symbols in an ignore file are ignored in columns 1 and 3 of the 
output. If an only file is given, only symbols in that file will appear in column 1. Only one of these options 
may be given; the default setting is -i using the default ignore file (see FILES below). Assembler pre¬ 
defined symbols or C keywords are ignored. 

The -s option causes current symbols to be put in column 3. In the assembler, the current symbol is the 
most recent name symbol; in C, the current function name. The -I option causes the line number within the 
file to be put in column 3. 

The -t option causes the next available argument to be used as the name of the intermediate file (instead of 
the temporary file /tmp/crt??). This file is created and is not removed at the end of the process. 

The cref options are: 

a assembler format (default) 
c C format input 
i use an ignore file (see above) 

1 put line number in column 3 (instead of current symbol) 
n omit column 4 (no context) 
o use an only file (see above) 
s current symbol in column 3 (default) 

t user-supplied temporary file 

u print only symbols that occur exactly once 
X print only C external symbols 

1 sort output on column 1 (default) 

2 sort output on column 2 

3 sort output on column 3. 

FILES 

/tmp/crt?? temporaries 

/usr/lib/cref/aign default assembler ignore file 

/usr/lib/cref/atab grammar table for assembler files 

/usr/lib/cref/cign default C ignore file 

/usr/lib/cref/ctab grammar table for C files 

/usr/lib/cref/crpost post-processor 

/usr/lib/cref/upost post-processor for -u option 

SEE ALSO 

as(l), cc(l), sort(l), xref(l). 

BUGS 

Cref inserts an ASCII DEL character into the intermediate file after the eighth character of each name that is 
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eight or more characters long in the source file. 
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NAME 

cron - clock daemon 

SYNOPSIS 

/etc/cron 

DESCRIPTION 

Cron executes commands at specified dates and times according to the instructions in the file 
/usr/lib/crontab. Because cron never exits, it should be executed only once. This is best done by running 
cron from the initialization process through the file /etc/rc (see m/r(8)). 

The file crontab consists of lines of six fields each. The fields are separated by spaces or tabs. The first 
five are integer patterns that specify the minute (0-59), hour (0-23), day of the month (1-31), month of the 
year (1-12), and day of the week (0-6, with 0=Sunday). Each of these patterns may contain: 

a number in the (respective) range indicated above; 
two numbers separated by a minus (indicating an inclusive range); 
a list of numbers separated by commas (meaning all of these numbers); or 
an asterisk (meaning all legal values). 

The sixth field is a string that is executed by the shell at the specified time(s). A % in this field is translated 
into a new-line character. Only the first line (up to a % or the end of line) of the command field is executed 
by the shell. The other lines are made available to the command as standard input. 

Cron examines crontab once a minute to see if it has changed; if it has, cron reads it. Thus it takes only a 
minute for entries to become effective. 


FILES 

/usr/lib/crontab 

/usr/lib/cronlog 

SEE ALSO 

sh(l), init(8). 

DIAGNOSTICS 

A history of all actions by cron are recorded in /usr/lib/cronlog. 

BUGS 

Cron reads crontab only when it has changed, but it reads the in-core version of that table once a minute. 
A more efficient algorithm could be used. The overhead in running cron is about one percent of the CPU, 
exclusive of any commands executed by cron. 
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NAME 

crypt - encode/decode 

SYNOPSIS 

crypt [ password ] 

DESCRIPTION 

Crypt reads from the standard input and writes on the standard output. The password is a key that selects a 
particular transformation. If no password is given, crypt demands a key from the terminal and turns off 
printing while the key is being typed in. Crypt encrypts and decrypts with the same key: 

crypt key <clear >cypher 
crypt key <cypher I pr 

will print the clear. 

Files encrypted by crypt are compatible with those treated by the editor ed in encryption mode. 

The security of encrypted files depends on three factors: the fundamental method must be hard to solve; 
direct search of the key space must be infeasible; “sneak paths” by which keys or clear text can become 
visible must be minimized. 

Crypt implements a one-rotor machine designed along the lines of the German Enigma, but with a 256- 
element rotor. Methods of attack on such machines are known, but not widely; moreover the amount of 
work required is likely to be large. 

The transformation of a key into the internal settings of the machine is deliberately designed to be expen¬ 
sive, i.e. to take a substantial fraction of a second to compute. However, if keys are restricted to (say) three 
lower-case letters, then encrypted files can be read by expending only a substantial fraction of five minutes 
of machine time. 

Since the key is an argument to the crypt command, it is potentially visible to users executing /?.?(!) or a 
derivative. To minimize this possibility, crypt takes care to destroy any record of the key immediately 
upon entry. The choice of keys and key security are the most vulnerable aspect of crypt. 

FILES 

/dev/tty for typed key 

SEE ALSO 

ed(l), makekey(8). 

BUGS 

If output is piped to nrojf{\) and the encryption key is not given on the command line, crypt can leave ter¬ 
minal modes in a strange state (see ^^^(l)). 
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NAME 

csplit - context split 
SYNOPSIS 

csplit [-s] [-k] [-f prefix] file argl [. . . argn] 

DESCRIPTION 

Csplit reads file and separates it into n+1 sections, defined by the arguments argl . . . argn. By default the 
sections are placed in xxOO .. . xxn (n may not be greater than 99). These sections get the following 
pieces of file: 

00: From the start of file up to (but not including) the line referenced by argl. 

01: From the line referenced by argl up to the line referenced by argl. 

n+1: From the line referenced by argn to the end of file. 

The options to csplit are: 

-s Csplit normally prints the character counts for each file created. If the -s option is pre¬ 

sent, csplit suppresses the printing of all character counts. 

-k Csplit normally removes created files if an error occurs. If the -k option is present, csplit 
leaves previously created files intact. 

-f prefix If the -f option is used, the created files are named prefixOO . . . prefixn. The default is 

xxOO . . . xxn. 

The arguments {argl . . . argn) to csplit can be a combination of the following: 

/rexpl A file is to be created for the section from the current line up to (but not including) the line 
containing the regular expression rexp. The current line becomes the line containing 
rexp. This argument may be followed by an optional +or - some number of lines (e.g., 
! 

%rexp% This argument is the same as Irexpl, except that no file is created for the section. 

Inno A file is to be created from the current line up to (but not including) Inno. The current 
line becomes Inno. 

{num} Repeat argument. This argument may follow any of the above arguments. If it follows a 
rexp type argument, that argument is applied num more times. If it follows Inno, the file 
will be split every Inno lines (num times) from that point. 

Enclose all rexp type arguments that contain blanks or other characters meaningful to the Shell in the 
appropriate quotes. Regular expressions may not contain embedded new-lines. Csplit does not affect the 
original file; it is the users responsibility to remove it. 

EXAMPLES 

csplit-f cobol file '/procedure division/' /par5./ /parl6./ 

This example creates four files, cobolOO . . . cobol03. After editing the “split” files, they can be recom¬ 
bined as follows: 

cat cobol0[0-3] > file 

Note that this example overwrites the original file, 
csplit-k file 100 {99) 

This example would split the file at every 100 lines, up to 10,000 lines. The -k option causes the created 
files to be retained if there are less than 10,000 lines; however, an error message would still be printed. 
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csplit-kprog.c '%main(%' 'r}/+l' {20} 

Assuming that prog.c follows the normal C coding convention of ending routines with a } at the beginning 
of the line, this example will create a file containing each separate C routine (up to 21) in prog.c. 

SEE ALSO 

ed(l), sh(l), regexp(7). 

DIAGNOSTICS 

Self explanatory except for: 

arg - out of range 

which means that the given argument did not reference a line between the current position and the end of 
the file. 
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NAME 

ct - call terminal 
SYNOPSIS 

ct [ -h ] [ -V ] [ -wn ] [ -sspeed ] telno 
DESCRIPTION 

Ct dials the phone number of a modem that is attached to a terminal, and spawns a login process to that ter¬ 
minal. Telno is the telephone number, with minus signs at appropriate places for delays. 

Ct determines which dialers are associated with lines that are set to the appropriate speed by examining the 
file /usr/lib/uucp/L-devices. If all such available dialers are busy, ct will ask if it should wait for a line, 
and if so, for how many minutes it should wait before it gives up. Ct will continue to try to open the dialers 
at one-minute intervals until the specified limit is exceeded. The dialogue may be overridden by specifying 
the -wn option, where n is the maximum number of minutes that ct is to wait for a line. 

Normally, ct will hang up the current line, so that that line can answer the incoming call. The -h option 
will prevent this action. If the -v option is used, ct will send a running narrative to standard error. 

The data rate may be set with the -s option, where speed is expressed in baud. The default rate is 300. 

The destination terminal must be attached to a modem that can answer the telephone. 

FILES 

/usr/lib/uucp/L-devices 
SEE ALSO 

cu(lC), login(l), uucp(lC), dn(4), getty(8). 
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NAME 

cu - call another UNIX system 
SYNOPSIS 

cu [-sspeed] [-aacu] [-lline] [-h] [-o|-e] telno I dir 
DESCRIPTION 

Cu calls up another UNIX system, a terminal, or possibly a non-UNIX system. It manages an interactive 
conversation with possible transfers of ASCII files. Speed gives the transmission speed (110, 150, 300, 
1200, 4800, 9600); 300 is the default value. Most of our modems restrict us to choose between 300 and 
1200. Directly connected lines may be set to other speeds. 

The -a and -1 values may be used to specify device names for the ACU and communications line devices. 
They can be used to override searching for the first available ACU with the right speed. The -h option emu¬ 
lates local echo, supporting calls to other computer systems which expect terminals to be in half-duplex 
mode. The -e (-o) option designates that even (odd) parity is to be generated for data sent to the remote. 
Telno is the telephone number, with equal signs for secondary dial tone or minus signs for delays, at appro¬ 
priate places. The string dir for telno must be used for direcdy connected lines, and implies a null ACU. 

Cu will try each line listed in the file /usr/lib/uucp/L-devices until it finds an available line with appropri¬ 
ate attributes or runs out of entries. After making the connection, cu runs as two processes: the transmit 
process reads data from the standard input and, except for lines beginning with ^ passes it to the remote 
system; the receive process accepts data from the remote system and, except for lines beginning with ", 
passes it to the standard output. Normally, an automatic DC3/DC1 protocol is used to control input from the 
remote so the buffer is not overrun. Lines beginning with " have special meanings. 

The transmit process interprets the following: 

terminate the conversation, 
escape to an interactive shell on the local system, 
run cmd on the local system (via sh -c). 
run cmd locally and send its output to the remote system. 

copy file from (on the remote system) to file to on the local system. If to is omit¬ 
ted, the/ram argument is used in both places. 

copy file/ram (on local system) to file to on remote system. If to is omitted, the 
from argument is used in both places. 

send the line “... to the remote system. 

turn off the DC3/DC1 input control protocol for the remainder of the session. This 
is useful in case the remote system is one which does not respond properly to the 
DC3 and DCl characters, 

The receive process normally copies data from the remote system to its standard output. A line from the 
remote that begins with "> initiates an output diversion to a file. The complete sequence is: 

~>l>]:file 

zero or more lines to be written to file 
“> 

Data from the remote is diverted (or appended, if » is used) to file. The trailing "> terminates the diver¬ 
sion. 

The use of *'%put requires .vffyfl) and cat{l) on the remote side. It also requires that the current erase and 
kill characters on the remote system be identical to the current ones on the local system. Backslashes are 
inserted at appropriate places. 

The use of ‘■%take requires the existence of echo(\) and cat(l) on the remote system. Also, stty tabs 
mode should be set on the remote system if tabs are to be copied without expansion. 


“Icmd... 

‘'$cmd... 

take/raw [ to ] 

*'%put/ram [ to ] 

“nostop 
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FILES 

/usr/lib/uucp/L-devices 
/usr/spool/uucp/LCK..(tty-device) 

/dev/null 

SEE ALSO 

cat(l), echo(l), stty(l), uucp(lC), dh(4), dii(4), tty(4). 

DIAGNOSTICS 

Exit code is zero for normal exit, non-zero (various values) otherwise. 

BUGS 

There is an artificial slowing of transmission by cu during the ''%put operation so that loss of data is 
unlikely. 
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NAME 

cut - cut out selected fields of each line of a file 
SYNOPSIS 

cut -clist[filel file2 ...] 

cut -flist [-debar] [-s] [filel file2 ...] 

DESCRIPTION 

Use cut to cut out columns from a table or fields from each line of a file; in data base parlance, it imple¬ 
ments the projection of a relation. The fields as specified by list can be fixed length, i.e., character positions 
as on a punched card (-c option), or the length can vary from line to line and be marked with a field delim¬ 
iter character like tab (-f option). Cut can be used as a filter; if no files are given, the standard input is 
used. 

The meanings of the options are: 

list A comma-separated list of integer field numbers (in increasing order), with optional - to indicate 
ranges as in the -o option of nroffitrojf for page ranges; e.g., 1,4,7; 1-3,8; -5,10 (short for 1-5,10); 
or 3- (short for third through last field). 

-clist The list following -c (no space) specifies character positions (e.g., -cl-72 would pass the first 72 
characters of each line). 

-Uist The list following -f is a list of fields assumed to be separated in the file by a delimiter character 
(see -d ); e.g. , -fl,7 copies the first and seventh field only. Lines with no field delimiters will be 
passed through intact (useful for table subheadings), unless -s is specified. 

-Achar The character following -d is the field delimiter (-f option only). Default is tab. Space or other 
characters with special meaning to the shell must be quoted. 

-s Suppresses lines with no delimiter characters in case of -f option. Unless specified, lines with no 
delimiters will be passed through untouched. 

Either the -c or -f option must be specified. 

HINTS 

Use grepil) to make horizontal “cuts” (by context) through a file, or paste{l) to put files together 
column-wise (i.e., horizontally). To reorder columns in a table, use cut and paste. 

EXAMPLES 

cut -d: -fl,5 /etc/passwd mapping of user IDs to names 

name='- who am i I cut -fl -d" to set name to current login name. 

DIAGNOSTICS 

line too long A line can have no more than 511 characters or fields. 

bad list for c/f option 

Missing -c or -f option or incorrectly specified list. No error occurs if a line has 
fewer fields than the list calls for. 

no fields The list is empty. 

SEE ALSO 

grep(l), paste(l). 
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NAME 

cw, checkcw - prepare constant-width text for troff 
SYNOPSIS 

cw [ -Ixx ] [ -rxx ] [ -fn ] [ -t ] [ +t ] [ -d ] [ files ] 
checkcw [ -Ixx ] [ -rxx ] files 
DESCRIPTION 

Cw is a preprocessor for trojf{l) input files that contain text to be typeset in the constant-width (CW) font. 

Text typeset with the CW font resembles the output of terminals and of line printers. This font is used to 
typeset examples of programs and of computer output in user manuals, programming texts, etc. (An earlier 
version of this font was used in typesetting The C Programming Language by B. W. Kernighan and D. M. 
Ritchie). It has been designed to be quite distinctive (but not overly obtrusive) when used together with the 
Times Roman font. 

Because the CW font contains a “non-standard” set of characters and because text typeset with it requires 
different character and inter-word spacing than is used for “standard” fonts, documents that use the CW 
font must be preprocessed by cw. 

The CW font contains the 94 printing ASCII characters: 

abcdefghijklmnopqrstuvwxyz 

ABCDEFGHIJKLMNOPQRSTUVWXYZ 

0123456789 

!$%&()‘’++@.,/:;=?[] I }# 

plus eight non-ASCII characters represented by four-character trojf{l) names (in some cases attaching these 
names to “non-standard” graphics), as follows: 

rll cll no r c i . Character Symbol Troff Name _ “Cents” sign %0% %%(ct% EBCDIC 

“not” sign %— 1 % %%(no% Left arrow %<—% %%(<-% Right arrow %—>% %%(- 
>% Down arrow %i% %%(da% Vertical single quote %'% %%(fm% Control-shift 

indicator %t% %%(dg% Visible space indicator %□% %%(sq% Hyphen%-% %%(hy% 

The hyphen is a synonym for the unadorned minus sign (-). Certain versions of cw recognize two addi¬ 
tional names: %\(ua% for an up arrow and %\(lh% for a diagonal left-up (home) arrow. 

Cw recognizes five request lines, as well as user-defined delimiters. The request lines look like trojf{\) 
macro requests, and are copied in their entirety by cw onto its output; thus, they can be defined by the user 
as troffil) macros; in fact, the %.CW% and %.CN% macros should be so defined (see HINTS below). 

The five requests are: 

.CW Start of text to be set in the CW font; %.CW% causes a break; it can take precisely the same 
options, in precisely the same format, as are available on the cw command line. 

.CN End of text to be set in the CW font; %.CN% causes a break; it can take the same options as are 
available on the cw command line. 

.CD Change delimiters and/or settings of other options; takes the same options as are available on the 
cw command line. 

.CP argl argl arg3 ... argn 

All the arguments (which are delimited like troff(l) macro arguments) are concatenated, with the 
odd-numbered arguments set in the CW font and the even-numbered ones in the prevailing font. 

.PC argl argl arg3 ... argn 

Same as %.CP%, except that the even-numbered (rather than odd-numbered) arguments are set in 
the CW font. 

The %.CW% and %.CN% requests are meant to bracket text (e.g., a program fragment) that is to be typeset 
in the CW font “as is.” Normally, cw operates in the transparent mode. In that mode, except for the 
%.CD% request and the nine special four-character names listed in the table above, every character between 
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%.CW% and %.CN% request lines stands for itself. In particular, cw arranges for periods (.) and apostro¬ 
phes (’) at the beginning of lines, and backslashes (%) and ligatures %ff%, etc.) everywhere to be 

“hidden” from trqff(l). The transparent mode can be turned off (see below), in which case normal troff(\) 
rules apply. In any case, cw hides from the user the effect of the font changes generated by the %.CW% 
and %.CN% requests. 

The only purpose of the %.CD% request is to allow the changing of various options other than just at the 
beginning of a document. 

The user can also define delimiters. The left and right delimiters perform the same function as the 
%.CW%/%.CN% requests; they are meant, however, to enclose CW “words” or “phrases” in running text 
(see the example under BUGS below). Cw treats text enclosed by delimiters in precisely the same manner 
as text bracketed by %.CW%/%.CN% pairs, except that, for aesthetic reasons, spaces in text bracketed by 
%.CW%/%.CN% pairs have the same width as any other CW character, while spaces between delimiters 
are half as wide, so that they have the same width as spaces in the prevailing text (but are not adjustable). 

Delimiters have no special meaning inside %.CW% /%.CN% pairs. 

The options are: 

•hex The one- or two-character string xr becomes the left delimiter; if xx is omitted, the left delimiter 
becomes undefined, which it is initially. 

•rxx Same for the right delimiter. The left and right delimiters may (but need not) be different. 

•fn The CW font is mounted in font position n; acceptable values for n are 1, 2, and 3 (default is 3, 

replacing the bold font). This option is only useful at the beginning of a document. 

-t Turn transparent mode ojf. 

-i-t Turn transparent mode on (this is the initial default). 

-d Print current option settings on file descriptor 2 in the form of trojf{\) comment lines. This option 
is meant for debugging. 

Cw reads the standard input when no files are specified, so it can be used as a filter. Typical usage is: 
cw files I troff... 

Checkew checks that left and right delimiters, as well as the %.CW%/%.CN% pairs, are properly balanced. 
It prints out all offending lines. 

HINTS 

Typical definitions of the %.CW% and %.CN% macros meant to be used with the mm(7) macro package: 

At the very least, the %.CW% macro should invoke the troffil) no-fill (% nf%) mode. 

When set in running text, the CW font is meant to be set in the same point size as the rest of the text. In dis¬ 
played matter, on the other hand, it can often be profitably set one point smaller than the prevailing point 
size (the displayed definitions of and %.CN% above are one point smaller than the running text on 

this page). The CW font is sized so that, when it is set in 9-point, there are 12 characters per inch. 

Documents that contain CW text may also contain tables and/or equations. If this is the case, the order of 
preprocessing should be: cw, thl, and eqn. Usually, the tables contained in such documents will not con¬ 
tain any CW text, although it is entirely possible to have elements of the table set in the CW font; of course, 
care must be taken that tbl{\) format information not be modified by cw. Attempts to set equations in the 
CW font are not likely to be either pleasing or successful. 

In the CW font, overstriking is most easily accomplished with backspaces: letting %<—% represent a back¬ 
space, %d<—<— dg% yields %d%. Because spaces (and, therefore backspaces) are half as wide between 
delimiters as inside %.CW%/%.CN% pairs (see above), two backspaces are required for each overstrike 
between delimiters. 

FILES 


/usr/lib/font/ftCW CW font-width table 
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SEE ALSO 

eqn(l), mmt(l), tbl(l), troff(l), mm(7), mv(7). 

WARNINGS 

If text preprocessed by cw is to make any sense, it must be set on a typesetter equipped with the CW font or 
on the MHCC STARE facility; on the latter, the CW font appears as bold, but with the proper CW spacing. 

BUGS 

Only a masochist would use periods (%.%) or backslashes (%) as delimiters. 

Certain CW characters don’t concatenate gracefully with certain Times Roman characters, e.g., a CW 
ampersand (%&%) followed by a Times Roman comma(%,%); in such cases, judicious use of troff(\) half- 
and quarter-spaces (% % and %%) is most salutary, e.g., one should use %_&_,% (rather than just plain 
%_&_,%) to obtain %&%, (assuming that %_% is used for both delimiters). 

Using cw with nroff is silly. 

The output of cw is hard to read. 

See also BUGS under troJf(l). 
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NAME 

date - print and set the date 

SYNOPSIS 

date [ mmddhhmm[yy] ] [ +format ] 

DESCRIPTION 

If no argument is given, or if the argument begins with +, the current date and time are printed. Otherwise, 
the current date is set. The first mm is the month number; dd is the day number in the month; hh is the 
hour number (24 hour system); the second mm is the minute number; yy is the last 2 digits of the year num¬ 
ber and is optional. For example: 

date 10080045 

sets the date to Oct 8, 12:45 AM. The current year is the default if no year is mentioned. The system oper¬ 
ates in GMT. Date takes care of the conversion to and from local standard and daylight time. 

If the argument begins with +, the output of date is under the control of the user. The format for the output 
is similar to that of the first argument to printf(3S). All output fields are of fixed size (zero padded if neces¬ 
sary). Each field descriptor is preceded by % and will be replaced in the output by its corresponding value. 
A single % is encoded by % %. All other characters are copied to the output without change. The string is 
always terminated with a new-line character. 

Field Descriptors: 

n insert a new-line character 

t insert a tab character 

m month of year - 01 to 12 
d day of month - 01 to 31 
y last 2 digits of year - 00 to 99 
D date as mm/dd/yy 

H hour - 00 to 23 

M minute - 00 to 59 

S second - 00 to 59 

T time as HH:MM:SS 

j Julian date - 001 to 366 

w day of week - Sunday = 0 
a abbreviated weekday - Sun to Sat 
h abbreviated month - Jan to Dec 
r time in AM/PM notation 

EXAMPLE 

date '+DATE: %m/%d/%y%nTIME: %H:%M:%S' 
would generate as output: 

DATE: 08/01/76 
TIME: 14:45:05 

DIAGNOSTICS 

No permission if you aren’t the super-user and you try to change the date; 

bad conversion if the date set is syntactically incorrect; 
had format character if the field descriptor is not recognizable. 

FILES 


/dev/kmem 
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NAME 

dc - desk calculator 

SYNOPSIS 

dc [ file ] 

DESCRIPTION 

Dc is an arbitrary precision arithmetic package. Ordinarily it operates on decimal integers, but one may 
specify an input base, output base, and a number of fractional digits to be maintained. The overall structure 
of dc is a stacking (reverse Polish) calculator. If an argument is given, input is taken from that file until its 
end, then from the standard input. The following constructions are recognized: 

number 

The value of the number is pushed on the stack. A number is an unbroken string of the digits 0-9. 
It may be preceded by an underscore (_) to input a negative number. Numbers may contain decimal 
points. 

The top two values on the stack are added (+), subtracted (-), multiplied (*), divided {/), remain¬ 
dered (%), or exponentiated The two entries are popped off the stack; the result is pushed on 
the stack in their place. Any fractional part of an exponent is ignored. 

sj: The top of the stack is popped and stored into a register named x, where may be any character. If 

the s is capitalized, x is treated as a stack and the value is pushed on it. 

\x The value in register is pushed on the stack. The register x is not altered. All registers start with 
zero value. If the 1 is capitalized, register x is treated as a stack and its top value is popped onto the 
main stack. 

d The top value on the stack is duplicated. 

p The top value on the stack is printed. The top value remains unchanged. P interprets the top of the 

stack as an ASCII string, removes it, and prints it. 

f All values on the stack are printed. 

q exits the program. If executing a string, the recursion level is popped by two. If q is capitalized, the 
top value on the stack is popped and the string execution level is popped by that value. 

X treats the top element of the stack as a character string and executes it as a string of dc commands. 

X replaces the number on the top of the stack with its scale factor. 

[... ] puts the bracketed ASCII string onto the top of the stack. 

<x >JC =x 

The top two elements of the stack are popped and compared. Register x is evaluated if they obey 
the stated relation. 

V replaces the top element on the stack by its square root. Any existing fractional part of the argument 
is taken into account, but otherwise the scale factor is ignored. 

! interprets the rest of the line as a UNIX command, 
c All values on the stack are popped. 

i The top value on the stack is popped and used as the number radix for further input. I pushes the 
input base on the top of the stack. 

o The top value on the stack is popped and used as the number radix for further output. 

O pushes the output base on the top of the stack. 

k the top of the stack is popped, and that value is used as a non-negative scale factor: the appropriate 
number of places are printed on output, and maintained during multiplication, division, and expo¬ 
nentiation. The interaction of scale factor, input base, and output base will be reasonable if all are 
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changed together. 

z The stack level is pushed onto the stack. 

Z replaces the number on the top of the stack with its length. 

? A line of input is taken from the input source (usually the terminal) and executed. 

; : are used by be for array operations. 

EXAMPLE 

This example prints the first ten values of n!: 

[lal+dsa*plalO>y]sy 

Osal 

lyx 

SEE ALSO 

bc(l), which is a preprocessor for dc providing infix notation and a C-like syntax which implements func¬ 
tions and reasonable control structures for programs. 

DIAGNOSTICS 

X is unimplemented 

where x is an octal number. 

stack empty 

for not enough elements on the stack to do what was asked. 

Out of space 

when the free list is exhausted (too many digits). 

Out of headers 

for too many numbers being kept around. 

Out of pushdown 

for too many items on the stack. 

Nesting Depth 

for too many levels of nested execution. 
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NAME 

dd - convert and copy a file 

SYNOPSIS 

dd [option=value]... 

DESCRIPTION 

Dd copies the specified input file to the specified output with possible conversions. The standard input and 
output are used by default. The input and output block size may be specified to take advantage of raw 
physical I/O. 

option values 

\f=file input file name; standard input is default 

of=file output file name; standard output is default 

ibs=« input block size n bytes (default 512) 

obs=n output block size (default 512) 

hs=n set both input and output block size, superseding its and obs-, also, if no conversion is 

specified, it is particularly efficient since no in-core copy need be done 
cbs=n conversion buffer size 

skip=rt skip n input records before starting copy 

seek=n seek n records from beginning of output file before copying 

count=rt copy only n input records 

conv=ascii convert EBCDIC to ASCII 

ebcdic convert ASCII to EBCDIC 

ibm slightly different map of ASCII to EBCDIC 
lease map alphabetics to lower case 
ucase map alphabetics to upper case 
swab swap every pair of bytes 

noerror 

do not stop processing on an error 
sync pad every input record to ibs 
....... several comma-separated conversions 

Where sizes are specified, a number of bytes is expected. A number may end with k, b, or w to specify 
multiplication by 1024, 512, or 2 respectively; a pair of numbers may be separated by x to indicate a prod¬ 
uct. 

Cbs is used only if ascii or ebcdic conversion is specified. In the former case ebs characters are placed into 
the conversion buffer, converted to ASCII, and trailing blanks trimmed and new-line added before sending 
the line to the output. In the latter case ASCII characters are read into the conversion buffer, converted to 
EBCDIC, and blanks added to make up an output record of size cbs. 

After completion, dd reports the number of whole and partial input and output blocks. 

EXAMPLE 

This command will read an EBCDIC tape blocked ten 80-byte EBCDIC card images per record into the 
ASCII file X: 

dd if=/dev/rmtO of=x ibs=800 cbs=80 conv=ascii,lcase 

Note the use of raw magtape. Dd is especially suited to I/O on the raw physical devices because it allows 
reading and writing in arbitrary record sizes. 

SEE ALSO 

cp(l). 
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DIAGNOSTICS 

f+p records m(out) numbers of full and partial records read(written) 

BUGS 

The ASCII/EBCDIC conversion tables are taken from the 256 character standard in the CACM Nov, 1968. 
The ibm conversion, while less blessed as a standard, corresponds better to certain IBM print train conven¬ 
tions. There is no universal solution. 

New-lines are inserted only on conversion to ASCII; padding is done only on conversion to EBCDIC. These 
should be separate options. 
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NAME 

delta - make a delta (change) to an SCCS file 
SYNOPSIS 

delta [-rSID] [-s] [-n] [-glist] [-m[mrlist]] [-y[comment]] [-p] files 
DESCRIPTION 

Delta is used to permanently introduce into the named SCCS file changes that were made to the file 
retrieved by get{\) (called the g-file, or generated file). 

Delta makes a delta to each named SCCS file. If a directory is named, delta behaves as though each file in 
the directory were specified as a named file, except that non-SCCS files (last component of the path name 
does not begin with s.) and unreadable files are silently ignored. If a name of - is given, the standard input 
is read (see WARNINGS)', each line of the standard input is taken to be the name of an SCCS file to be pro¬ 
cessed. 

Delta may issue prompts on the standard output depending upon certain keyletters specified and flags (see 
admin{\.)) that may be present in the SCCS file (see -m and -y keyletters below). 

Keyletter arguments apply independently to each named file. 

-rSID Uniquely identifies which delta is to be made to the SCCS file. The use of this 

keyletter is necessary only if two or more outstanding gets, for editing (get -e) on 
the same SCCS file were done by the same person (login name). The SID value 
specified with the -r keyletter can be either the SID specified on the get command 
line or the SID to be made as reported by the get command (see get{\.)). A diag¬ 
nostic results if the specified SID is ambiguous, or, if necessary and omitted on the 
command line. 

-s Suppresses the issue, on the standard output, of the created delta’s SID, as well as 

the number of lines inserted, deleted and unchanged in the SCCS file. 

-n Specifies retention of the edited g-file (normally removed at completion of delta 

processing). 

-glist Specifies a list (see get{\) for the definition of list) of deltas which are to be 

ignored when the file is accessed at the change level (SID) created by this delta. 

-m[mrlist] If the SCCS file has the v flag set (see admin(l)) then a Modification Request (MR) 

number must be supplied as the reason for creating the new delta. 

If -m is not used and the standard input is a terminal, the prompt MRs? is issued 
on the standard output before the standard input is read; if the standard input is not 
a terminal, no prompt is issued. The MRs? prompt always precedes the 
comments? prompt (see -y keyletter). 

MRs in a list are separated by blanks and/or tab characters. An unescaped new- 
line character terminates the MR list. 

Note that if the v flag has a value (see admin(\)), it is taken to be the name of a 
program (or shell procedure) which will validate the correctness of the MR num¬ 
bers. If a non-zero exit status is returned from MR number validation program, 
delta terminates (it is assumed that the MR numbers were not all valid). 

-y[comment] Arbitrary text used to describe the reason for making the delta. A null string is 
considered a valid comment. 

If -y is not specified and the standard input is a terminal, the prompt comments? 
is issued on the standard output before the standard input is read; if the standard 
input is not a terminal, no prompt is issued. An unescaped new-line character ter¬ 
minates the comment text. 
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-p Causes delta to print (on the standard output) the SCCS file differences before and 

after the delta is applied in a diffil) format. 


FILES 

All files of the form .^-file are explained in the Source Code Control System User’s Guide. The naming 
convention for these files is also described there. 


g-file Existed before the execution of delta ; removed after completion of delta. 

p-file Existed before the execution of delta ; may exist after completion of delta. 

q-file Created during the execution of delta ; removed after completion of delta. 

x-file Created during the execution of delta-, renamed to SCCS file after completion of delta. 

z-file Created during the execution of delta-, removed during the execution of delta. 

d-file Created during the execution of delta ; removed after completion of delta. 

/usr/bin/bdiff Program to compute differences between the “gotten” file and the g-jile. 

WARNINGS 

Lines beginning with an SOH ASCII character (binary 001) cannot be placed in the SCCS file unless the 
SOH is escaped. This character has special meaning to SCCS (see sccsfile(5)) and will cause an error. 

A get of many SCCS files, followed by a delta of those files, should be avoided when the get generates a 
large amount of data. Instead, multiple get/delta sequences should be used. 

If the standard input (-) is specified on the delta command line, the -m (if necessary) and -y keyletters 
must also be present. Omission of these keyletters causes an error to occur. 

SEE ALSO 

admin(l), bdiff(l), get(l), help(l), prs(l), sccsfile(5). 

Source Code Control System User’s Guide by L. E. Bonanni and C. A. Salemi. 

DIAGNOSTICS 

Use helpU) for explanations. 
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NAME 

deroff - remove nroff/troff, tbl, and eqn constructs 
SYNOPSIS 

deroff [ -w ] [ -mx ] [ files ] 

DESCRIPTION 

Deroff reads each of the files in sequence and removes all troffil) requests, macro calls, backslash con¬ 
structs, eqn{l) constructs (between .EQ and .EN lines, and between delimiters), and tbl(].) descriptions, and 
writes the remainder of the file on the standard output. Deroff follows chains of included files (.so and nx 
troff commands); if a file has already been included, a .so naming that file is ignored and a nx naming that 
file terminates execution. If no input file is given, deroff reads the standard input. 

The -m option may be followed by an m, s, or 1. The resulting -mm or -ms option causes the mm or ms 
macros to be interpreted so that only running text is output (i.e., no text from macro lines.) The -ml option 
forces the -mm option and also causes deletion of lists associated with the mm macros. 

If the -w option is given, the output is a word list, one “word” per line, with all other characters deleted. 
Otherwise, the output follows the original, with the deletions mentioned above. In text, a “word” is any 
string that contains at least two letters and is composed of letters, digits, ampersands (&), and apostrophes 
('); in a macro call, however, a “word” is a string that begins with at least two letters and contains a total 
of at least three letters. Delimiters are any characters other than letters, digits, apostrophes, and amper¬ 
sands. Trailing apostrophes and ampersands are removed from “words.” 

SEE ALSO 

eqn(l), tbl(l), troff(l). 

BUGS 

Deroff is not a complete troff interpreter, so it can be confused by subtle constructs. Most such errors result 
in too much rather than too little output. 

The -ml option does not handle nested lists correctly. 



DEVNM(IM) 


DEVNM(IM) 


NAME 

devnm - device name 

SYNOPSIS 

/etc/devnm [ names ] 

DESCRIPTION 

Devnm identifies the special file associated with the mounted file system where the argument name resides. 

This command is most commonly used by /etc/rc (see rc(8)) to construct a mount table entry for the root 
device. 

EXAMPLE 

The command: 

/etc/devnm /usr 

produces 

rpl /usr 

if /usr is mounted on /dev/rpl. 

FILES 

/dev/rp* 

/etc/mnttab 

SEE ALSO 

setmnt(lM). 
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NAME 

df - report number of free disk blocks 
SYNOPSIS 

df [ -t ] [ -f ] [ file-systems ] 

DESCRIPTION 

Df prints out the number of free blocks and free i-nodes available for on-line file systems by examining the 
counts kept in the super-blocks; file-systems may be specified either by device name (e.g., /dev/rpl) or by 
mounted directory name (e.g., /usr). If \hQ file-systems argument is unspecified, the free space on all of the 
mounted file systems is printed. 

The -t flag causes the total allocated block figures to be reported as well. 

If the -f flag is given, only an actual count of the blocks in the free list is made (free i-nodes are not 
reported). With this option, df will report on raw devices. 

FILES 

/dev/rf* 

/dev/rk* 

/dev/rp* 

/etc/mnttab 

SEE ALSO 

fsck(lM), fs(5), mnttab(5). 
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NAME 

diff- differential file comparator 
SYNOPSIS 

diff [ -efbh ] filel file2 
DESCRIPTION 

Dijf tells what lines must be changed in two files to bring them into agreement. If filel (file!) is the stan¬ 
dard input is used. If filel (filel) is a directory, then a file in that directory with the name filel (filel) is 
used. The normal output contains lines of these forms: 

nl a n3,n4 
nl,nl d n3 
nl.nl c n3,n4 

These lines resemble ed commands to convert filel into filel. The numbers after the letters pertain to filel. 
In fact, by exchanging a for d and reading backward one may ascertain equally how to convert filel into 
filel. As in ed, identical pairs where nl = nl or n3 = n4 are abbreviated as a single number. 

Following each of these lines come all the lines that are affected in the first file flagged by <, then all the 
lines that are affected in the second file flagged by >. 

The -b option causes trailing blanks (spaces and tabs) to be ignored and other strings of blanks to compare 
equal. 

The -e option produces a script of a, c and d commands for the editor ed, which will recreate filel from 
filel. The -f option produces a similar script, not useful with ed, in the opposite order. In connection with 
-e, the following shell program may help maintain multiple versions of a file. Only an ancestral file ($1) 
and a chain of version-to-version ed scripts ($2,$3,...) made by dijf need be on hand. A “latest version” 
appears on the standard output. 

(shift; cat $*; echo'l,$p') I ed-$l 

Except in rare circumstances, dijf finds a smallest sufficient set of file differences. 

Option -h does a fast, half-hearted job. It works only when changed stretches are short and well separated, 
but does work on files of unlimited length. Options -e and -f are unavailable with -h. 

FILES 

/tmp/d????? 

/usr/lib/diffh for -h 

SEE ALSO 

cmp(l), comm(l), ed(l). 

DIAGNOSTICS 

Exit status is 0 for no differences, 1 for some differences, 2 for trouble. 

BUGS 

Editing scripts produced under the -e or -f option are naive about creating lines consisting of a single 
period (.). 
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NAME 

diffi - 3-way differential file comparison 
SYNOPSIS 

diff3[-ex3]filel file2 file3 
DESCRIPTION 

DijfS compares three versions of a file, and publishes disagreeing ranges of text flagged with these codes: 
==== all three files differ 

====1 filel is different 

====2 filel is different 

====3 fileS is different 

The type of change suffered in converting a given range of a given file to some other is indicated in one of 
these ways: 

/: a Text is to be appended after line number nl in file/, where/ = 1, 2, or 3. 

f: nl , n2 c Text is to be changed in the range line nl to line n2. If nl = nl, the range 

may be abbreviated to nl. 

The original contents of the range follows immediately after a c indication. When the contents of two files 
are identical, the contents of the lower-numbered file is suppressed. 

Under the -e option, dijf3 publishes a script for the editor ed that will incorporate into filel all changes 
betweenand fileS, i.e., the changes that normally would be flagged ==== and ====3. Option -x (-3) 
produces a script to incorporate only changes flagged ==== (====3). The following command will apply 
the resulting script to filel. 

(cat script; echo'l,$p') I ed-filel 

FILES 

/tmp/d3* 

/usr/lib/diff3prog 

SEE ALSO 

diff(l). 

BUGS 

Text lines that consist of a single . will defeat -e. 

Files longer than 64K bytes won’t work. 
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NAME 

diffmk - mark differences between files 
SYNOPSIS 

diffmk name 1 name2 name3 
DESCRIPTION 

Diffmk compares two versions of a file and creates a third file that includes “change mark” commands for 
nroff(\) or Namel and name! are the old and new versions of the file. Diffmk generates nameS, 

which contains the lines of namel plus inserted formatter “change mark” (.me) requests. When nameS is 
formatted, changed or inserted text is shown by I at the right margin of each line. The position of deleted 
text is shown by a single *. 

If anyone is so inclined, he can use diffmk to produce listings of C (or other) programs with changes 
marked. A typical command line for such use is: 

diffmk old.c new.c tmp; nroff macs tmp I pr 
where the file macs contains: 

.pi 1 
.11 77 
.nf 
.eo 
.nc ' 

The .11 request might specify a different line length, depending on the nature of the program being printed. 
The .eo and .nc requests are probably needed only for C programs. 

If the characters I and * are inappropriate, a copy of diffmk can be edited to change them {diffmk is a shell 
procedure). 

SEE ALSO 

diff(l), nroff(l). 

BUGS 

Aesthetic considerations may dictate manual adjustment of some output. File differences involving only 
formatting requests may produce undesirable output, i.e., replacing .sp by .sp 2 will produce a “change 
mark’ ’ on the preceding or following line of output. 
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NAME 

dircmp - directory comparison 

SYNOPSIS 

dircmp dirl dir2 

DESCRIPTION 

Dircmp examines dirl and dir2 and generates various tabulated information about the contents of the 
directories. Listings of files that are unique to each directory are generated in addition to a list that indicates 
whether the files common to both directories have the same contents. 

SEE ALSO 

cmp(l), diff(l). 
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NAME 

dpd, odpd, Ipd - HONEYWELL sending daemons, line printer daemon 

SYNOPSIS 

/usr/lib/dpd 

/usr/lib/odpd 

/usr/lib/lpd 

DESCRIPTION 

Dpd and odpd are the daemons for the 200-series DATA-PHONE.nh 


set and for the Murray Hill Spider network. They are designed to submit jobs to the HONEYWELL 6000 
computer via the CRTS interface. For systems with both Spider and DATA-PHONE connections to the MH 
HONEYWELL 6000 computer, dpd is the Spider daemon, and odpd is the DATA-PHONE set daemon, and is 
used automatically as a backup when the Spider link is down. On other systems, there is only one daemon, 
dpd, which uses the DATA-PHONE set. Lpd is the daemon for the line printer. 

Dpd and odpd use the directory /usr/spool/dpd. Lpd uses the directory /usr/spool/lpd. The file lock in 
either directory is used to prevent two daemons from becoming active. After the program has successfully 
set the lock, it forks and the main path exits, thus spawning the daemon. The directory is scanned for files 
beginning with “df”. Each such file is submitted as a job. Each line of a job file must begin with a key 
character to specify what to do with the remainder of the line. 

S directs dpd to generate a unique snumb card. The snumh number is generated from the file snumb 
in the spooling directory in the case of the DATA-PHONE set daemon, or it is read from the PDP-8 
that interfaces to GCOS in the case of the Spider daemon. This key character is not used by lpd. 

L specifies that the remainder of the line is to be sent as a literal. 

I is the same as L, but signals the $ IDENT card which is to be mailed back by the mail option. 

B specifies that the rest of the line is a file name. That file is to be sent as binary cards. 

F is the same as B except a form-feed is prepended to the file. 

U specifies that the rest of the line is a file name. After the job has been transmitted, the file is 
unlinked. 

M is followed by a user ID; after the job is sent, a message is mailed to the user via the mail(\) com¬ 
mand to verify the sending of the job. 

N is followed by a user file name, to be sent back under the mail option. (Not used by lpd). 

Q is followed by a string of characters, which is a message to be sent back to the user under the mail 

option. (Not used by lpd). 

Any error encountered will cause the daemon to drop the call, wait up to 20 minutes, (only 10 seconds for 
lpd), and start over. This means that an improperly constructed “df ’ file may cause the same job to be 
submitted every 20 minutes. 

Dpd is automatically initiated by all of the GCOS commands, (dpr, gcat,fget, mAfsend) and by /etc/rc. 
On systems with both dpd daemons, odpd is automatically initiated by dpd on certain errors from Spider. 
Lpd is automatically initiated by the line printer command, Ipr. 

To restart dpd or lpd (in the case of hardware or software malfunction), it is necessary to first kill the old 
daemon (if it is still alive), and remove the lock file (if present), before initiating the new daemon. This is 
done automatically by /etc/rc when the system is brought up, in case there were any jobs left in the spool¬ 
ing directory when the system last went down. 


FILES 

/usr/spool/dpd/* 

/usr/spool/lpd/* 

/etc/passwd 

/dev/du? 

/dev/dn? 


spool area for GCOS daemons, 
spool area for line printer daemon, 
to get the user’s name. 

DATA-PHONE set. 

ACU device for use with the DATA-PHONE set. 
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/dev/lp line printer device. 

SEE ALSO 

dpr(lC), fget(lC), fget.demon(lC), fsend(lC), gcat(lC), Ipr(l). 
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NAME 

dpr - off-line print 
SYNOPSIS 

dpr [ -destination ] [ options ] [ files ] 

DESCRIPTION 

Dpr causes the named files to be printed off-line at the specified destination, by GCOS at the Murray Hill 
Computation Center. GCOS identification must appear in the UNIX password file (see passwd{5)), or be 
supplied by the -i option. If no files are listed the standard input is assumed; thus dpr may be used as a 
filter. 

The destination is a two-character code which is taken to be a Murray Hill GCOS “station id.” Useful 
codes are rl for quality print, and ql for quality print with special ribbon, both on regular wide paper. The 
codes r2 and q2 give the same print on narrow paper. The default destination is on-line at the Murray Hill 
Computation Center. 

The following options, each as a separate argument, and in any combination (multiple outputs are permit¬ 
ted), may be given before or after the destination: 

-c Makes a copy of the file to be sent before returning to the user. 

-r Removes the file after sending it. 

-f Uses the next argument as a dummy file name to report back in the mail. (This is useful for distin¬ 
guishing multiple runs, especially when dpr is being used as a filter). 

-i Supplies the GCOS “ident card” image as the parameter AMxxxx^yyy where Mxxxx is the GCOS 
job number and Myyy the GCOS bin number. 

-m When transmission is complete, reports by mail{\) the so-called snumb of the receiving GCOS job. 
The mail is sent by the UNIX daemon; there is no guarantee that the GCOS job ran successfully. 
This is the default option. 

-n Does not report the completion of transmission by 

-sn Submits job to GCOS with service grade n («=1, 2, 3). Default is -s2. 

EXAMPLES 

The command: 

dpr -r -n error 1 error! 

will send the files errorl and error2 to GCOS for printing, removing the files after they have been sent, but 
not sending mail. The line: 

pr filel I dpr -si -f jobl -rl 

will send the output of pr to GCOS for printing on the quality printer with service grade 1, and will send 
mail that johl has been sent. 

FILES 

/etc/passwd 
/usr/lib/dpd 
/usr/spool/dpd/* 

SEE ALSO 

dpd(lC), fget(lC), fsend(lC), gcat(lC). 


user’s identification and GCOS ident card, 
sending daemon, 
spool area. 
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NAME 

du - summarize disk usage 

SYNOPSIS 

du [ -ars ] [ names ] 

DESCRIPTION 

Du gives the number of blocks contained in all files and (recursively) directories within each directory and 
file specified by the names argument. The block count includes the indirect blocks of the file. If names is 
missing,. is used. 

The optional argument -s causes only the grand total (for each of the specified names) to be given. The 
optional argument -a causes an entry to be generated for each file. Absence of either causes an entry to be 
generated for each directory only. 

Du is normally silent about directories that cannot be read, files that cannot be opened, etc. The -r option 
will cause du to generate messages in such instances. 

A file with two or more links is only counted once. 

BUGS 

If the -a option is not used, non-directories given as arguments are not listed. 

If there are too many distinct linked files, du will count the excess files more than once. 

Files with holes in them will get an incorrect block count. 
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NAME 

dump - incremental file system dump 
SYNOPSIS 

dump [ key [ arguments ] file-system ] 

DESCRIPTION 

Dump copies to magnetic tape all files changed after a certain date in the file-system. The key specifies the 
date and other options about the dump. Key consists of characters from the set 0123456789fusd. 

f Place the dump on the next argument file instead of the tape. 

u If the dump completes successfully, write the date of the beginning of the dump on file /etc/ddate. 

This file records a separate date for each file system and each dump level. 

0-9 This number is the “dump level”. All files modified since the last date stored in the file /etc/ddate 
for the same file system at lesser levels will be dumped. If no date is determined by the level, the 
beginning of time is assumed; thus the option 0 causes the entire file system to be dumped, 
s The size of the dump tape is specified in feet. The number of feet is taken from the next argument. 
When the specified size is reached, the dump will wait for reels to be changed. The default size is 
2,300 feet. 

d The density of the tape, expressed in BPI, is taken from the next argument. This is used in calculat¬ 
ing the amount of tape used per write. The default is 1600. 

If no arguments are given, the key is assumed to be 9u and a default file system is dumped to the default 
tape. 

Now a short suggestion on how to perform dumps. Start with a full level-0 dump: dump Ou. Next, peri¬ 
odic level-9 dumps should be made on an exponential progression of tapes. (Sometimes called Tower of 
Hanoi: 1, 2, 1, 3, 1,2, 1,4,...; tape 1 used every other time, tape 2 is used every fourth, tape 3 is used 
every eighth, etc.): dump 9u. When the level-9 incremental approaches a full tape (about 78,000 blocks at 
1600 BPI blocked 20 blocks per record), a level-1 dump should be made: dump lu. After this, the expo¬ 
nential series should progress as if uninterrupted. These level-9 dumps are based on the level-1 dump, 
which is based on the level-0 full dump. This progression of levels of dumps can be carried as far as 
desired. 

FILES 

default file system and tape vary with installation. 

/etc/ddate: record dump dates of file system/level. 

SEE ALSO 

cpio(l), restor(lM), volcopy(lM), dump(5). 

DIAGNOSTICS 

If the dump requires more than one tape, it will ask you to change tapes. Reply with a new-line after this 
has been done. 


BUGS 

Sizes are based on 1600 BPI blocked tape. The raw magnetic tape device has to be used to approach these 
densities. Read errors on the file system are ignored. Write errors on the magnetic tape are usually fatal. 
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NAME 

echo - echo arguments 

SYNOPSIS 

echo [ arg ] ... 

DESCRIPTION 

Echo writes its arguments separated by blanks and terminated by a new-line on the standard output. It also 
understands C-like escape conventions; beware of conflicts with the shell’s use of \: 

\b backspace 

\c print line without new-line 

\f form-feed 

\n new-line 

\r carriage return 

\t tab 

W backslash 

\n the 8-bit character whose ASCII code is the 1-, 2- or 3-digit octal number n, which must 
start with a zero. 

Echo is useful for producing diagnostics in command files and for sending known data into a pipe. 

SEE ALSO 

sh(l). 
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NAME 

ed - text editor 

SYNOPSIS 

ed[-][-x][file] 

DESCRIPTION 

Ed is the standard text editor. If the file argument is given, ed simulates an e command (see below) on the 
named file; that is to say, the file is read into ed's, buffer so that it can be edited. The optional - suppresses 
the printing of character counts by e, r, and w commands, of diagnostics from e and q commands, and of 
the ! prompt after a Ishell command. If -x is present, an x command is simulated first to handle an 
encrypted file. Ed operates on a copy of the file it is editing; changes made to the copy have no effect on 
the file until a w (write) command is given. The copy of the text being edited resides in a temporary file 
called the buffer. There is only one buffer. 

Commands to ed have a simple and regular structure; zero, one, or two addresses followed by a single¬ 
character command, possibly followed by parameters to that command. These addresses specify one or 
more lines in the buffer. Every command that requires addresses has default addresses, so that the 
addresses can very often be omitted. 

In general, only one command may appear on a line. Certain commands allow the input of text. This text 
is placed in the appropriate place in the buffer. While ed is accepting text, it is said to be in input mode. In 
this mode, no commands are recognized; all input is merely collected. Input mode is left by typing a period 
(.) alone at the beginning of a line. 

Ed supports a limited form of regular expression notation; regular expressions are used in addresses to 
specify lines and in some commands (e.g., 5 ) to specify portions of a line that are to be substituted. A regu¬ 
lar expression (RE) specifies a set of character strings. A member of this set of strings is said to be matched 
by the RE. The REs allowed by ed are constructed as follows: 

The following one-character REs match a .single character: 

1.1 An ordinary character (not one of those discussed in 1.2 below) is a one-character RE that matches 
itself. 

1.2 A backslash (\) followed by any special character is a one-character RE that matches the special char¬ 
acter itself. The special characters are: 

a. ., *, [, and \ (period, asterisk, left square bracket, and backslash, respectively), which are always 
special, except when they appear within square brackets ([ ]; see 1.4 below). 

b. '' (caret or circumflex), which is special at the beginning of an entire RE (see 3.1 and 3.2 below), 
or when it immediately follows the left of a pair of square brackets ([]) (see 1.4 below). 

c. $ (currency symbol), which is special at the end of an entire RE (see 3.2 below). 

d. The character used to bound (i.e., delimit) an entire RE, which is special for that RE (for example, 
see how slash (/) is used in the g command, below.) 

1.3 A period (.) is a one-character RE that matches any character except new-line. 

1.4 A non-empty string of characters enclosed in square brackets ([]) is a one-character RE that 
matches any one character in that string. If, however, the first character of the string is a 
circumflex (''), the one-character RE matches any character except new-line and the remaining 
characters in the string. The '' has this special meaning only if it occurs first in the string. The 
minus (-) may be used to indicate a range of consecutive ASCII characters; for example, [0-9] is 
equivalent to [0123456789]. The - loses this special meaning if it occurs first (after an initial 

if any) or last in the string. The right square bracket (]) does not terminate such a string when it 
is the first character within it (after an initial if any); e.g., [ ]a-f] matches either a right square 
bracket (]) or one of the letters a through f inclusive. The four characters listed in 1.2.a above 
stand for themselves within such a string of characters. 
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The following rules may be used to construct RE& from one-character REs: 

2.1 A one-character RE is a RE that matches whatever the one-character RE matches. 

2.2 A one-character RE followed by an asterisk (*) is a RE that matches zero or more occurrences of 
the one-character RE. If there is any choice, the longest leftmost string that permits a match is 
chosen. 

2.3 A one-character RE followed by or is a RE that matches a range of occur¬ 

rences of the one-character RE. The values of m and n must be non-negative integers less than 
256; \{m\} matches exactly m occurrences; matches at least m occurrences; \{w,«\} 

matches any number of occurrences between m and n inclusive. Whenever a choice exists, the 
RE matches as many occurrences as possible. 

2.4 The concatenation of REs is a RE that matches the concatenation of the strings matched by each 
component of the RE. 

2.5 A RE enclosed between the character sequences \( and \) is a RE that matches whatever the 
unadorned RE matches. 

2.6 The expression \n matches the same string of characters as was matched by an expression 
enclosed between \( and \) earlier in the same RE. Here n is a digit; the sub-expression 
specified is that beginning with the n-th occurrence of \( counting from the left. For example, 
the expression ''\(.*\)\1$ matches a line consisting of two repeated appearances of the same 
string. 

Finally, an entire RE may be constrained to match only an initial segment or final segment of a line 
(or both): 

3.1 A circumfiex ('') at the beginning of an entire RE constrains that RE to match an initial segment 
of a line. 

3.2 A currency symbol ($) at the end of an entire RE constrains that RE to match o. final segment of 
a line. The construction '"'entire RE$ constrains the entire RE to match the entire line. 

The null RE (e.g., //) is equivalent to the last RE encountered. See also the last paragraph before 
FILES below. 

To understand addressing in ed it is necessary to know that at any time there is a current line. Gener¬ 
ally speaking, the current line is the last line affected by a command; the exact effect on the current 
line is discussed under the description of each command. Addresses are constructed as follows: 

1. The character. addresses the current line. 

2. The character $ addresses the last line of the buffer. 

3. A decimal number n addresses the n-th line of the buffer. 

4. x addresses the line marked with the mark name character j:, which must be a lower-case letter. 
Lines are marked with the k command described below. 

5. A RE enclosed by slashes (/) addresses the first line found by searching/orwarJ from the line 
following the current line toward the end of the buffer and stopping at the first line containing a 
string matching the RE. If necessary, the search wraps around to the beginning of the buffer and 
continues up to and including the current line, so that the entire buffer is searched. See also the 
last paragraph before FILES below. 

6. A RE enclosed in question marks (?) addresses the first line found by searching backward from 
the line preceding the current line toward the beginning of the buffer and stopping at the first 
line containing a string matching the RE. If necessary, the search wraps around to the end of the 
buffer and continues up to and including the current line. See also the last paragraph before 
FILES below. 
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7. An address followed by a plus sign (+) or a minus sign (-) followed by a decimal number 
specifies that address plus (respectively minus) the indicated number of lines. The plus sign 
may be omitted. 

8. If an address begins with + or the addition or subtraction is taken with respect to the current 
line; e.g, -5 is understood to mean .-5. 

9. If an address ends with + or then 1 is added to or subtracted from the address, respectively. 
As a consequence of this rule and of rule 8 immediately above, the address - refers to the line 
preceding the current line. (To maintain compatibility with earlier versions of the editor, the 
character '' in addresses is entirely equivalent to -.) Moreover, trailing + and - characters have 
a cumulative effect, so — refers to the current line less 2. 

10. For convenience, a comma (,) stands for the address pair 1,$, while a semicolon (;) stands for 
the pair .,$. 

Commands may require zero, one, or two addresses. Commands that require no addresses regard the 
presence of an address as an error. Commands that accept one or two addresses assume default 
addresses when an insufficient number of addresses is given; if more addresses are given than such a 
command requires, the last one(s) are used. 

Typically, addresses are separated from each other by a comma (,). They may also be separated by a 
semicolon (;). In the latter case, the current line (.) is set to the first address, and only then is the sec¬ 
ond address calculated. This feature can be used to determine the starting line for forward and back¬ 
ward searches (see rules 5. and 6. above). The second address of any two-address sequence must cor¬ 
respond to a line that follows, in the buffer, the line corresponding to the first address. 

In the following list of ed commands, the default addresses are shown in parentheses. The parenthe¬ 
ses are not part of the address; they show that the given addresses are the default. 

It is generally illegal for more than one command to appear on a line. However, any command 
(except e,f,r,orw) may be suffixed by p or by I, in which case the current line is either printed or 
listed, respectively, as discussed below under the p and / commands. 

(.)a 

<text> 

The append command reads the given text and appends it after the addressed line;. is left at 
the last inserted line, or, if there were none, at the addressed line. Address 0 is legal for this 
command: it causes the “appended” text to be placed at the beginning of the buffer. 

(-)c 

<text> 

The change command deletes the addressed lines, then accepts input text that replaces these 
lines;. is left at the last line input, or, if there were none, at the first line that was not deleted. 

(.,.)d 

The cfelete command deletes the addressed lines from the buffer. The line after the last line 
deleted becomes the current line; if the lines deleted were originally at the end of the buffer, 
the new last line becomes the current line. 

e file 

The edit command causes the entire contents of the buffer to be deleted, and then the named 
file to be read in;. is set to the last line of the buffer. If no file name is given, the currently- 
remembered file name, if any, is used (see the/command). The number of characters read is 
typed; file is remembered for possible use as a default file name in subsequent e, r, and w 
commands. If file begins with !, the rest of the line is taken to be a shell ish(l)) command 
whose output is to be read. Such a shell command is not remembered as the current file 
name. See also DIAGNOSTICS below. 
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Efile 

The Edit command is like e, except that the editor does not check to see if any changes have 
been made to the buffer since the last w command. 

ffile 

If file is given, the/ile-name command changes the currently-remembered file name to file-, 
otherwise, it prints the currently-remembered file name. 

(1, $ )g/RElcommand list 

In the global command, the first step is to mark every line that matches the given RE. Then, 
for every such line, the given command list is executed with . initially set to that line. A sin¬ 
gle command or the first of a list of commands appears on the same line as the global com¬ 
mand. All lines of a multi-line list except the last line must be ended with a \; a, i, and c 
commands and associated input are permitted; the . terminating input mode may be omitted 
if it would be the last line of the command list. An empty command list is equivalent to the 
p command. The g, G, v, and V commands are not permitted in the command list. See also 
BUGS and the last paragraph before FILES below. 

(1,$)G/R£/ 

In the interactive Global command, the first step is to mark every line that matches the given 
RE. Then, for every such line, that line is printed,. is changed to that line, and any one com¬ 
mand (other than one of the a, c, i, g, G, v, and V commands) may be input and is executed. 
After the execution of that command, the next marked line is printed, and so on; a new-line 
acts as a null command; an & causes the re-execution of the most recent command executed 
within the current invocation of G. Note that the commands input as part of the execution of 
the G command may address and affect any lines in the buffer. The G command can be ter¬ 
minated by an interrupt signal (ASCII DEL or BREAK). 

h 

The /lelp command gives a short error message that explains the reason for the most recent ? 
diagnostic. 

H 

The Help command causes ed to enter a mode in which error messages are printed for all 
subsequent ? diagnostics. It will also explain the previous ? if there was one. The H com¬ 
mand alternately turns this mode on and off; it is initially off. 

(.)i 

<text> 


The insert command inserts the given text before the addressed line; . is left at the last 
inserted line, or, if there were none, at the addressed line. This command differs from the a 
command only in the placement of the input text. Address 0 is not legal for this command. 

The Join command joins contiguous lines by removing the appropriate new-line characters. 
If only one address is given, this command does nothing. 

(.)kjr 

The mar^ command marks the addressed line with name x, which must be a lower-case let¬ 
ter. The address x then addresses this line;. is unchanged. 

(.,.)! 

The list command prints the addressed lines in an unambiguous way: a few non-printing 
characters (e.g., tab, backspace) are represented by (hopefully) mnemonic overstrikes, all 
other non-printing characters are printed in octal, and long lines are folded. An / command 
may be appended to any other command other than e,f, r, or w. 

(.,. )ini3 

The move command repositions the addressed line(s) after the line addressed by a. Address 
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0 is legal for a and causes the addressed line(s) to be moved to the beginning of the file; it is 
an error if address a falls within the range of moved lines;. is left at the last line moved. 

(.,.)n 

The number command prints the addressed lines, preceding each line by its line number and 
a tab character; . is left at the last line printed. The n command may be appended to any 
other command other than e,/, r, or w. 

The print command prints the addressed lines; . is left at the last line printed. The p com¬ 
mand may be appended to any other command other than e, f, r, or w; for example, dp 
deletes the current line and prints the new current line. 

P 

The editor will prompt with a * for all subsequent commands. The P command alternately 
turns this mode on and off; it is initially off. 

q 

The ^uit command causes ed to exit. No automatic write of a file is done (but see 
DIAGNOSTICS below). 

Q 

The editor exits without checking if changes have been made in the buffer since the last w 
command. 

The read command reads in the given file after the addressed line. If no file name is given, 
the currently-remembered file name, if any, is used (see e and/ commands). The currently- 
remembered file name is not changed unless file is the very first file name mentioned since 
ed was invoked. Address 0 is legal for r and causes the file to be read at the beginning of the 
buffer. If the read is successful, the number of characters read is typed;. is set to the last line 
read in. If file begins with !, the rest of the line is taken to be a shell (sh(l)) command whose 
output is to be read. Such a shell command is not remembered as the current file name. 

(.,. )sl re! replacement! or 

(.,. )slRElreplacementlg 

The substitute command searches each addressed line for an occurrence of the specified RE. 
In each line in which a match is found, all (non-overlapped) matched strings are replaced by 
the replacement if the global replacement indicator g appears after the command. If the glo¬ 
bal indicator does not appear, only the first occurrence of the matched string is replaced. It is 
an error for the substitution to fail on all addressed lines. Any character other than space or 
new-line may be used instead of / to delimit the RE and the replacement-, . is left at the last 
line on which a substitution occurred. See also the last paragraph before FILES below. 

An ampersand (&) appearing in the replacement is replaced by the string matching the RE 
on the current line. The special meaning of & in this context may be suppressed by preced¬ 
ing it by \. As a more general feature, the characters \n, where n is a digit, are replaced by 
the text matched by the n-th regular subexpression of the specified RE enclosed between \( 
and \). When nested parenthesized subexpressions are present, n is determined by counting 
occurrences of \( starting from the left. When the character % is the only character in the 
replacement, the replacement used in the most recent substitute command is used as the 
replacement in the current substitute command. The % loses its special meaning when it is 
in a replacement string of more than one character or is preceded by a \. 

A line may be split by substituting a new-line character into it. The new-line in the 
replacement must be escaped by preceding it by V Such substitution cannot be done as part 
of a g or V command list. 
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This command acts just like the m command, except that a copy of the addressed lines is 
placed after address a (which may be 0);. is left at the last line of the copy. 

u 

The Mndo command nullifies the effect of the most recent command that modified anything 
in the buffer, namely the most recent a, c, d, g, i,j, m, r, 5 , t, v, G, or V command. 

(1, $ )\lRElcommand list 

This command is the same as the global command g except that the command list is exe¬ 
cuted with . initially set to every line that does not match the RE. 

(1,$)V/R£/ 

This command is the same as the interactive global command G except that the lines that are 
marked during the first step are those that do not match the RE. 

(l,$)w^/e 

The write command writes the addressed lines into the named file. If the file does not exist, 
it is created with mode 666 (readable and writable by everyone), unless your umask setting 
(see sh(l)) dictates otherwise. The currently-remembered file name is not changed unless 
file is the very first file name mentioned since ed was invoked. If no file name is given, the 
currently-remembered file name, if any, is used (see e and / commands); . is unchanged. If 
the command is successful, the number of characters written is typed. \i file begins with !, 
the rest of the line is taken to be a shell (sh(l)) command whose output is to be read. Such a 
shell command is not remembered as the current file name. 

X 

A key string is demanded from the standard input. Subsequent e, r, and w commands will 
encrypt and decrypt the text with this key by the algorithm of crypt(\). An explicitly empty 
key turns off encryption. 

($)= 

The line number of the addressed line is typed;. is unchanged by this command. 

Ishell command 

The remainder of the line after the ! is sent to the UNIX shell (sh(].)) to be interpreted as a 
command. Within the text of that command, the unescaped character % is replaced with the 
remembered file name; if a ! appears as the first character of the shell command, it is replaced 
with the text of the previous shell command. Thus, !! will repeat the last shell command. If 
any expansion is performed, the expanded line is echoed;. is unchanged. 

(.+l)<new-line> 

An address alone on a line causes the addressed line to be printed. A new-line alone is 
equivalent to .+lp; it is useful for stepping forward through the buffer. 

If an interrupt signal (ASCII DEL or BREAK) is sent, ed prints a ? and returns to its command level. 

Some size limitations: 512 characters per line, 256 characters per global command list, 64 characters 
per file name, and 128K characters in the buffer. The limit on the number of lines depends on the 
amount of user memory: each line takes 1 word. 

When reading a file, ed discards ASCII NUL characters and all characters after the last new-line. Files 
(e.g., a.out) that contain characters not in the ASCII set (bit 8 on) cannot be edited by ed. 

If the closing delimiter of a RE or of a replacement string (e.g., /) would be the last character before a 
new-line, that delimiter may be omitted, in which case the addressed line is printed. The following 
pairs of commands are equivalent: 
s/sl/s2 s/sl/s2/p 
g/sl g/sl/p 

?sl ?sl? 
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FILES 

/tmp/e# temporary; # is the process number, 

ed.hup work is saved here if the terminal is hung up. 

DIAGNOSTICS 

? for command errors. 

?file for an inaccessible file. 

(use the help and //elp commands for detailed explanations). 

If changes have been made in the buffer since the last w command that wrote the entire buffer, ed warns the 
user if an attempt is made to destroy ed's buffer via the e or ^ commands: it prints ? and allows one to con¬ 
tinue editing. A second e or q command at this point will take effect. The - command-line option inhibits 
this feature. 

SEE ALSO 

crypt(l), grep(l), sed(l), sh(l). 

A Tutorial Introduction to the UNIX Text Editor by B. W. Kernighan. 

Advanced Editing on UNIX by B. W. Kernighan. 

CAVEATS AND BUGS 

A .' command cannot be subject to a g or a v command. 

The ! command and the ! escape from the e, r, and w commands cannot be used if the the editor is invoked 
from a restricted shell (see sh{l)). 

The sequence \n in a RE does not match any character. 

The I command mishandles DEL. 

Files encrypted directly with the crypt(\) command with the null key cannot be edited. 

Because 0 is an illegal address for the w command, it is not possible to create an empty file with ed. 
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NAME 

efl - Extended Fortran Language 

SYNOPSIS 

efl [ options ] [ files ] 

DESCRIPTION 

Efl compiles a program written in the EFL language into clean Fortran on the standard output. Efl provides 
the C-like control constructs of mtfor{l): 

statement grouping with braces, 
decision-making: 

if, if-else, and select-case (also known as switch-case); 
while, for, Fortran do, repeat, and repeat... until loops; 
multi-level break and next. 

EFL has C-like data structures, e.g.: 
struct 


integer flags(3) 
character(8) name 
long real coords(2) 

} table(lOO) 

The language offers generic functions, assignment operators (+=, &=, etc.), and sequentially evaluated logi¬ 
cal operators (&& and I I). There is a uniform input/output syntax: 

write(6,x,y:f(7,2), do i=l,10 { a(i,j),z.b(i) }) 

EFL also provides some syntactic “sugar”: 
free-form input: 

multiple statements per line; automatic continuation; statement label names (not just 
numbers). 

comments: 

# this is a comment. 

translation of relational and logical operators: 

>, >=, &, etc., become .GT., .GE., .AND., etc. 

return expression to caller from function: 
return (expression) 

defines: 

define name replacement 

includes: 

include 

Efl understands several option arguments: -w suppresses warning messages, -# suppresses comments in the 
generated program, and the default option -C causes comments to be included in the generated program. 

An argument with an embedded = (equal sign) sets an EFL option as if it had appeared in an option state¬ 
ment at the start of the program. Many options are described in the reference manual. A set of defaults for 
a particular target machine may be selected by one of the choices: system=unix, system=gcos, or 
system=cray. The default setting of the system option is the same as the machine the compiler is running 
on. Other specific options determine the style of input/output, error handling, continuation conventions, the 
number of characters packed per word, and default formats. 

Efl is best used with/77(l). 
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SEE ALSO 

cc(l), n7(l), ratfor(l). 

The Programming Language EFL by S.I. Feldman. 
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NAME 

env - set environment for command execution 
SYNOPSIS 

env [-] [ name=value ] ... [ command args ] 

DESCRIPTION 

Env obtains the current environment, modifies it according to its arguments, then executes the command 
with the modified environment. Arguments of the form name=value are merged into the inherited environ¬ 
ment before the command is executed. The - flag causes the inherited environment to be ignored com¬ 
pletely, so that the command is executed with exactly the environment specified by the arguments. 

If no command is specified, the resulting environment is printed, one name-value pair per line. 

SEE ALSO 

sh(l), exec(2), profile(5), environ(7). 



delim $$ 
NAME 


eqn, neqn, checkeq - format mathematical text for nroff or troff 
SYNOPSIS 

eqn [ -dxy ] [ -pn ] [ -sn ] [ -fn ] [ files ] 
neqn [ -dxy ] [ -pn ] [ -sn ] [ -fn ] [ files ] 
checkeq [ files ] 

DESCRIPTION 

Eqn is a trojf{\) preprocessor for typesetting mathematical text on a Wang Laboratories, Inc. C/A/T photo¬ 
typesetter, while neqn is used for the same purpose with nrojf{\) on typewriter-like terminals. Usage is 
almost always: 

eqn files I troff 
neqn files I nroff 

or equivalent. 

If no files are specified, these programs read from the standard input. A line beginning with .EQ marks the 
start of an equation; the end of an equation is marked by a line beginning with .EN. Neither of these lines is 
altered, so they may be defined in macro packages to get centering, numbering, etc. It is also possible to 
designate two characters as delimiters-, subsequent text between delimiters is then treated as eqn input. 
Delimiters may be set to characters and y with the command-line argument -dry or (more commonly) 
with delim xy between .EQ and .EN. The left and right delimiters may be the same character; the dollar 
sign is often used as such a delimiter. Delimiters are turned off by delim off. All text that is neither 
between delimiters nor between .EQ and .EN is passed through untouched. 

The program checkeq reports missing or unbalanced delimiters and .EQ/.EN pairs. 

Tokens within eqn are separated by spaces, tabs, new-lines, braces, double quotes, tildes, and circumflexes. 
Braces { } are used for grouping; generally speaking, anywhere a single character such as x could appear, a 
complicated construction enclosed in braces may be used instead. Tilde (~) represents a full space in the 
output, circumflex ('') half as much. 

Subscripts and superscripts are produced with the keywords sub and sup. Thus suh j makes $x sub j$, 
a sub k sup 2 produces $a sub k sup 2$, while $e sup {x sup 2 -i- y sup 2}$ is made with 
e sup (x sup 2 + y sup 2 j. Fractions are made with over: a over h yields $a over b$; sqrt makes square 
roots: 1 over sqrt {ax sup 2+bx+c} results in $1 over sqrt {ax sup 2 +bx+c}$ . 

The keywords from and to introduce lower and upper limits: $lim from (n -> inf) sum from 0 to n x sub i$ 
is made with Urn from (n -> inf j sum from 0 to n x sub i. Left and right brackets, braces, etc., of the 
right height are made with left and right: left [ x sup 2 + y sup 2 over alpha right ] 1 produces $left 

[ X sup 2 + y sup 2 over alpha right ] ~=' 1$. Legal characters after left and right are braces, brackets, bars, 
c and f for ceiling and floor, and "" for nothing at all (useful for a right-side-only bracket). A left thing 
need not have a matching right thing. 

Vertical piles of things are made with pile, Ipile, cpile, and rpile: pile {a above b above c} produces Spile 
(a above b above c}$. Piles may have arbitrary numbers of elements; Ipile left-justifies, pile and cpile cen¬ 
ter (but with different vertical spacing), and rpile right justifies. Matrices are made with matrix: matrix ( 
Icol { X sub i above y sub 2 } ccol { 1 above 2 } } produces Smatrix { Icol { x sub i above y sub 2 } ccol { 1 
above 2 } }$. In addition, there is rcol for a right-justified column. 

Diacritical marks are made with dot, dotdot, hat, tilde, bar, vec, dyad, and under: x dot = f(t) bar is $x 
dot = f(t) bar$, y dotdot bar ~ « under is $y dotdot bar '=' n underS, and j: vec ~ y dyad is $x vec 
y dyad$. 

Point sizes and fonts can be changed with size n or size ±n, roman, italic, bold, and font n. Point sizes 
and fonts can be changed globally in a document by gsize n and gfont n, or by the command-line argu¬ 
ments -sn and -fn. 

Normally, subscripts and superscripts are reduced by 3 points from the previous size; this may be changed 
by the command-line argument -pn. 

Successive display arguments can be lined up. Place mark before the desired lineup point in the first equa¬ 
tion; place lineup at the place that is to line up vertically in subsequent equations. 
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Shorthands may be defined or existing keywords redefined with define; 
define thing % replacement % 

defines a new token called thing that will be replaced by replacement whenever it appears thereafter. The 
% may be any character that does not occur in replacement. 

Keywords such as sum ( sum ), int (int), inf (inf), and shorthands such as >= (>=), != ( != ), and -> (->) 
are recognized. Greek letters are spelled out in the desired case, as in alpha ( alpha ), or GAMMA ( 
GAMMA ). Mathematical words such as sin, cos, and log are made Roman automatically. Trojf{\.) four- 
character escapes such as \(dd (t) and \(bs (\) may be used anywhere. Strings enclosed in double quotes 
("...") are passed through untouched; this permits keywords to be entered as text, and can be used to com¬ 
municate with troff{\) when all else fails. Full details are given in the manual cited below. 

SEE ALSO 

Typesetting Mathematics-User’s Guide by B. W. Kernighan and L. L. Cherry. 

New Graphic Symbols for EQN and NEQN by C. Scrocca. 
mm(l), mmt(l), tbl(l), troff (1), eqnchar(7), mm(7), mv(7). 

BUGS 

To embolden digits, parentheses, etc., it is necessary to quote them, as in bold ”12.3". 

See also BUGS under troJf(l). 



ERRDEAD(IM) 


ERRDEAD(IM) 


NAME 

errdead - extract error records from dump 
SYNOPSIS 

/etc/errdead dumpfile [ namelist ] 

DESCRIPTION 

When hardware errors are detected by the system, an error record that contains information pertinent to the 
error is generated. If the error-logging daemon errdemon{lM) is not active or if the system crashes before 
the record can be placed in the error file, the error information is held by the system in a local buffer. 
Errdead examines a system dump (or memory), extracts such error records, and passes them to errpt{\y\) 
for analysis. 

The dumpfile specifies the file (or memory) that is to be examined. The system namelist is specified by 
namelisf, if not given, /unix is used. 

FILES 

/unix system namelist 

/usr/bin/errpt analysis program 

/usr/tmp/errXXXXXX temporary file 

DIAGNOSTICS 

Diagnostics may come from either errdead or errpt. In either case, they are intended to be self- 
explanatory. 

SEE ALSO 

errdemon(lM), errpt(lM). 
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NAME 

errdemon - error-logging daemon 

SYNOPSIS 

/etc/errdemon [ file ] 

DESCRIPTION 

The error logging daemon errdemon collects error records from the operating system by reading the special 
file /dev/error and places them in file. If file is not specified when the daemon is activated, 
/usr/adm/errfile is used. Note that file is created if it does not exist; otherwise, error records are appended 
to it, so that no previous error data is lost. No analysis of the error records is done by errdemon -, that 
responsibility is left to errpt^UA). The error-logging daemon is terminated by sending it a software kill 
signal (see signal{2)). Only the super-user may start the daemon, and only one daemon may be active at 
any time. 

FILES 

/dev/error source of error records 
/usr/adm/errfile repository for error records 

DIAGNOSTICS 

The diagnostics produced by errdemon are intended to be self-explanatory. 

SEE ALSO 

errpt(lM), errstop(lM), kill(l), erT(4). 
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NAME 

errpt - process a report of logged errors 
SYNOPSIS 

errpt [-a] [-dev]... [-int] [ -mem ] [-s date] [-e date] [-pn] [ -f ] [files] 

DESCRIPTION 

Errpt processes data collected by the error logging mechanism {errdemoniXM)) and generates a report of 
that data. The default report is a summary of all errors posted in the files named. Options apply to all files 
and are described below. If no files are specified, errpt attempts to use /usr/adm/errfile as file. 

A summary report notes the options that may limit its completeness, records the time stamped on the earli¬ 
est and latest errors encountered, and gives the total number of errors of one or more types. Each device 
summary contains the total number of unrecovered errors, recovered errors, errors unabled to be logged, I/O 
operations on the device, and miscellaneous activities that occurred on the device. The number of times 
that errpt has difficulty reading input data is included as read errors. 

Any detailed report contains, in addition to specific error information, all instances of the error logging pro¬ 
cess being started and stopped, and any time changes (via date{\)) that took place during the interval being 
processed. A summary of each error type included in the report is appended to a detailed report. 

A report may be limited to certain records in the following ways: 

-s date Ignore all records posted earlier than date, where date has the form mmddhhmmyy, 

consistent in meaning with the date{X) command. 

-e date Ignore all records posted later than date, whose form is as described above. 

-a Produce a detailed report that includes all error types. 

-dev A detailed report is limited to dev, a block device identifier. Errpt is familiar with the 

common form of identifiers (e.g., rs03, RS04, hs; see Section 4 of this volume). Cur¬ 
rently, the block devices for which errors are logged are RP03, RP04, RP05, RP06, 
RS03, RS04, TUIO, TU16, RK05, and RFl 1. 

-int Include in a detailed report errors of the stray-interrupt type. 

-mem Include in a detailed report errors of the memory-parity type. 

-p n Limit the size of a detailed report to n pages. 

-f In a detailed report, limit the reporting of block device errors to unrecovered errors. 

FILES 

/usr/adm/errfile default error file 
SEE ALSO 

errdemon(lM), errfile(5). 
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NAME 

errstop - terminate the error-logging daemon 
SYNOPSIS 

/etc/errstop [ namelist ] 

DESCRIPTION 

The error-logging daemon errdemon{\y\) is terminated by using errstop. This is accomplished by execut¬ 
ing /75(1) to determine the daemon’s identity and then sending it a software kill signal (see signal{2))\ /unix 
is used as the system namelist if none is specified. Only the super-user may use errstop. 

FILES 

/unix default system namelist 
DIAGNOSTICS 

The diagnostics produced by errstop are intended to be self-explanatory. 

SEE ALSO 

errdemon(lM), ps(l), kill(2). 
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NAME 

expr - evaluate arguments as an expression 

SYNOPSIS 

expr arguments 

DESCRIPTION 

The arguments are taken as an expression. After evaluation, the result is written on the standard output. 
Terms of the expression must be separated by blanks. Characters special to the shell must be escaped. 
Note that 0 is returned to indicate a zero value, rather than the null string. Strings containing blanks or 
other special characters should be quoted. Integer-valued arguments may be preceded by a unary minus 
sign. Internally, integers are treated as 32-bit, 2’s complement numbers. 

The operators and keywords are listed below. Characters that need to be escaped are preceded by \. The 
list is in order of increasing precedence, with equal precedence operators grouped within {} symbols. 

expr\\ expr 

returns the first expr if it is neither null nor 0, otherwise returns the second expr. 
expr\& expr 

returns the first expr if neither expr is null or 0, otherwise returns 0. 
expr { =, \>, \>=, \<, \<=, != ) expr 

returns the result of an integer comparison if both arguments are integers, otherwise returns the 
result of a lexical comparison. 

expr { +, - } expr 

addition or subtraction of integer-valued arguments. 
expr { \*, /, % ) expr 

multiplication, division, or remainder of the integer-valued arguments. 
expr : expr 

The matching operator : compares the first argument with the second argument which must be a 
regular expression; regular expression syntax is the same as that of ed{\), except that all patterns 
are “anchored” (i.e., begin with '') and, therefore, ^ is not a special character, in that context. Nor¬ 
mally, the matching operator returns the number of characters matched (0 on failure). Alterna¬ 
tively, the \(... \) pattern symbols can be used to return a portion of the first argument. 

EXAMPLES 

1. a='expr $a + 1' 

adds 1 to the shell variable a. 

2. # ^For $a equal to either "/usr/abc/file" or just "file" ^ 

expr $a : \l $a 

returns the last segment of a path name (i.e., file). Watch out for / alone as an argument: 
expr will take it as the division operator (see BUGS below). 

3. # A better representation of example 2. 
expr //$a : ^.*A(.*\)^ 

The addition of the // characters eliminates any ambiguity about the division operator and 
simplifies the whole expression. 

4. expr $VAR : 

returns the number of characters in $VAR. 

SEE ALSO 

ed(l), sh(l). 

EXIT CODE 

As a side effect of expression evaluation, expr returns the following exit values: 
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0 if the expression is neither null nor 0 

1 if the expression is null or 0 

2 for invalid expressions. 

DIAGNOSTICS 

syntax error for operator/operand errors 

non-numeric argument if arithmetic is attempted on such a string 

BUGS 

After argument processing by the shell, expr cannot tell the difference between an operator and an operand 
except by the value. If $a is an =, the command: 

expr $a = 
looks like: 

expr = = = 

as the arguments are passed to expr (and they will all be taken as the = operator). The following works: 
expr X$a = X= 
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NAME 

f77 - Fortran 77 compiler 

SYNOPSIS 

f77 [ options ] files 


DESCRIPTION 

F77 is the UNIX Fortran 77 compiler; it accepts several types of files arguments: 

Arguments whose names end with f are taken to be Fortran 77 source programs; they are compiled 
and each object program is left in the current directory in a file whose name is that of the source, with 
.o substituted for f. 

Arguments whose names end with .r or .e are taken to be RATFOR or EFL source programs, respec¬ 
tively; these are first transformed by the appropriate preprocessor, then compiled by/77, producing .o 
files. 

In the same way, arguments whose names end with .c or .s are taken to be C or assembly source pro¬ 
grams and are compiled or assembled, producing .o files. 

The following options have the same meaning as in cc{\) (see ld{\) for link editor options): 

-c Suppress link editing and produce .o files for each source file. 

-p Prepare object files for profiling (see prof{l)). 

-O Invoke an object-code optimizer. 

-S Compile the named programs and leave the assembler-language output in corresponding 

files whose names are suffixed with .s. (No .o files are created.) 

-ooutput Name the final output file output, instead of a.out. 

-f In systems without floating-point hardware, use a version of/77 that handles floating-point 

constants and links the object program with the floating-point interpreter. 

The following options are peculiar to/77: 

-onetrip Compile DO loops that are performed at least once if reached. (Fortran 77 DO loops are not 
performed at all if the upper limit is smaller than the lower limit.) 

-u Make the default type of a variable “undefined”, rather than using the default Fortran rules, 

-w Suppress all warning messages. If the option is -w66, only Fortran 66 compatibility warn¬ 

ings are suppressed. 

-F Apply EFL and RATFOR preprocessor to relevant files, put the result in files whose names 

have their suffix changed to .of. (No .o files are created.) 

-m Apply the M4 preprocessor to each EFL or RATFOR source file before transforming with the 

ratfor(\) or efi(\) processors. 

-E The remaining characters in the argument are used as an EFL flag argument whenever pro¬ 

cessing a .e file. 

-R The remaining characters in the argument are used as a RATFOR flag argument whenever 

processing a .r file. 

Other arguments are taken to be either link-editor option arguments or /77-compilable object programs 
(typically produced by an earlier run), or libraries of /77-compilable routines. These programs, together 
with the results of any compilations specified, are linked (in the order given) to produce an executable pro¬ 
gram with the default name a.out. 


FILES 

file.[fresc] 

file.o 

a.out 

./fort[pid].? 

/usr/lib/f77passl 

/lib/cl 

/lib/c2 


input file 
object file 
linked output 
temporary 
compiler 
pass 2 

optional optimizer 
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/usr/lib/libF77.a intrinsic function library 

/usr/lib/libI77.a Fortran I/O library 

/lib/libc.a C library; see Section 3 of this Manual. 

SEE ALSO 

A Portable Fortran 77 Compiler by S. I. Feldman and P. J. Weinberger 
cc(l), efl(l), ld(l), m4(l), prof(l), ratfor(l). 

DIAGNOSTICS 

The diagnostics produced by f77 itself are intended to be self-explanatory. Occasional messages may be 
produced by the link editor ld{l). 
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NAME 

factor, primes - factor a number, generate large primes 

SYNOPSIS 

factor [ number ] 

primes 

DESCRIPTION 

When factor is invoked without an argument, it waits for a number to be typed in. If you type in a positive 
number less than a (about 7.2x10 °) it will factor the number and print its prime factors; each one is 
printed the proper number of times. Then it waits for another number. It exits if it encounters a zero or any 
non-numeric character. 

If factor is invoked with an argument, it factors the number as above and then exits. 

Maximum time to factor is proportional to and occurs when n is prime or the square of a prime. It takes 
1 minute to factor a prime near 10 on a PDP-11. 

When primes is invoked, it waits for a number to be typed in. If you type in a positive number less than 2^^ 
it will print all primes greater than or equal to this number. 

DIAGNOSTICS 

“Ouch” for input out of range or for garbage input. 
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NAME 

fget - retrieve files from the HONEYWELL 6000 
SYNOPSIS 

fget [ options ] [ files ] 

DESCRIPTION 

Fget arranges to have one or more GCOS files sent to UNIX. GCOS identification must appear in the UNIX 
password file (see passwd{5)), or be supplied by the -i option. Normally, the files retrieved will appear in 
the UNIX user’s current directory under the GCOS file name. 

The GCOS catalog from which the files are obtained depends on the form of the file name argument. If the 
file name has only embedded slashes, then it is assumed to be a full GCOS path name and that file is 
retrieved. If the file name has no embedded slashes or begins with a slash, then the GCOS catalog from 
which the file is retrieved is the same as the UNIX login name of the person who issues the command. If, 
however, a user has a different name in the third field of the GCOS “ident card image” (which image is 
extracted from the UNIX password file-see pass-wd{5y), this name is taken as the GCOS catalog name. 
Whatever GCOS catalog is finally used, the files must either have general read permission or the user must 
have arranged that the user ID network has read permission on that catalog fsend{\Cy). This can be 
accomplished with the GCOS command: 

filsys me <user ID>,(r)/network/ 

The UNIX file into which the retrieved GCOS file will ultimately be written is initialized with one line con¬ 
taining the complete GCOS file name. If the file contains the initial line for an extended period, it means 
that GCOS is down or something has gone horribly wrong and you should try again. 

The following options, each as a separate argument (or in the case of -d and -u, as two separate argu¬ 
ments), may appear in any order, but must precede all file arguments. 

-a Retrieve files as ASCII (default). 

-b Retrieve files as binary. 

-d Use the next argument as the UNIX directory into which retrieved files are written. 

-i Supply the GCOS “ident card” image as the parameter -iMxxxx,Myyy where Mxxxx is the GCOS 
job number and Myyy the GCOS bin number. 

-m When the request has been forwarded to GCOS, report by mail{\) the so-called snumb of the 
receiving job; mail is sent by the UNIX daemon; there is no guarantee that the GCOS job ran or that 
UNIX retrieved the output. This is the default option. 

-n Do not report the forwarding of the request by mn//(l). 

-o Print the on-line GCOS accounting output. 

-t Toss out the on-line GCOS accounting output. This is the default option. 

-sn Submit job to GCOS with service grade n («=1, 2, 3). Default is -si. 

-u Use the next argument as the GCOS catalog name for all files. 

EXAMPLES 

The command: 

fget -u gcosme -t -n -d /usr/me/test filel file! 

will retrieve the GCOS files gcosme/filel and gcosme/flle2, as the UNIX files /usr/me/test/filel and 
/usr/me/test/file2, respectively, but will not generate any mail or GCOS accounting output as a result of the 
transaction. 


EILES 

/etc/passwd 

/usr/lib/dpd 

/usr/spool/dpd/* 

/usr/lib/fget.demon 


user’s identification and GCOS ident card, 
sending daemon, 
spool area, 
retrieval daemon. 


SEE ALSO 

dpd(lC), dpr(lC), fsend(lC), fget.demon(lC), passwd(5). 
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NAME 

fget.demon, fget.odemon - file retrieval daemons 
SYNOPSIS 

/usr/lib/fget.demon time 
/usr/lib/fget.odemon time 

DESCRIPTION 

Fget.demon Sind fget.odemon are the retrieval daemons for the 200-series DATA-PHONE.nh 

set and for the Murray Hill Spider network. They are designed to retrieve files that have been requested by 
fget{\C) from the MH HONEYWELL 6000 computer. The argument time is the number of seconds for 
fget.demon to wait for files to appear from CRTS. The default is 6 minutes. Fget.demon is automatically 
initiated by^er(lC), and by cron(lM). 

On systems with both Spider and DATA-PHONE connections to the HONEYWELL 6000 computer, 
fget.demon uses Spider, and fget.odemon uses the DATA-PHONE set, and is called automatically as a 
backup when the Spider connection is down. On other systems, there is only one/ger dsitmon, fget.demon, 
which use the DATA-PHONE set. 

Thefget daemons use the spooling directory /usr/spool/dpd. The file glock in that directory is used to pre¬ 
vent two daemons from becoming active. After the program has successfully set the lock, it forks and the 
main path exits, thus spawning the daemon. CRTS is interrogated for any output for the daemon’s station- 
id. If none, fget.demon will wait up to time seconds, interrogating CRTS every minute or so to see if any 
output has arrived. All problems and successful transactions are recorded in the errors file in the spooling 
directory. 

To resizii fget.demon (in the case of hardware or software malfunction), it is necessary to first kill the old 
fget.demon (if still alive), and remove the lock file (if present), before initiating/get. Jemon. This is done 
automatically by /etc/rc when the system is brought up, in case there are any files waiting to come over. 

FILES 

/usr/spool/dpd/* spool area. 

/dev/du? DATA-PHONE set. 

/dev/dn? ACU device. 

SEE ALSO 

dpd(lC),fget(lC). 
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NAME 

file - determine file type 

SYNOPSIS 

file [-f ] file ... 

DESCRIPTION 

File performs a series of tests on each argument in an attempt to classify it. If an argument appears to be 
ASCII, file examines the first 512 bytes and tries to guess its language. If an argument is an executable 
a.out,^/e will print the version stamp, provided it is greater than 0 (see the description of the -V option in 
ld(\)). 

If the -f option is given, the next argument is taken to be a file containing the names of the files to be exam¬ 
ined. 
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NAME 

find - find files 
SYNOPSIS 

find path-name-list expression 
DESCRIPTION 

Find recursively descends the directory hierarchy for each path name in the path-name-list (i.e., one or 
more path names) seeking files that match a boolean expression written in the primaries given below. In 
the descriptions, the argument n is used as a decimal integer where +n means more than n, -n means less 
than n and n means exactly n. 

-name file True if file matches the current file name. Normal shell argument syntax may be used 

if escaped (watch out for [, ? and *). 

-perm onum True if the file permission flags exactly match the octal number onum (see chmod{\)). 

If onum is prefixed by a minus sign, more flag bits (017777, see statil)) become 
significant and the flags are compared: 

(flags&onum)~onum 

-type c True if the type of the file is c, where c is b, c, d, p, or f for block special file, character 

special file, directory, fifo (a.k.a named pipe), or plain file. 

-links n True if the file has n links. 

-user uname True if the file belongs to the user uname. If uname is numeric and does not appear as 

a login name in the /etc/passwd file, it is taken as a user ID. 

-group gname True if the file belongs to the group gname. If gname is numeric and does not appear 
in the /etc/group file, it is taken as a group ID. 

-size n True if the file is n blocks long (512 bytes per block). 

-atime n True if the file has been accessed in n days. 

-mtime n True if the file has been modified in n days. 

-dime n True if the file has been changed in n days. 

-exec cmd True if the executed cmd returns a zero value as exit status. The end of cmd must be 

punctuated by an escaped semicolon. A command argument {} is replaced by the cur¬ 
rent path name. 

-ok cmd Like -exec except that the generated command line is printed with a question mark 

first, and is executed only if the user responds by typing y. 

-print Always true; causes the current path name to be printed. 

-cpio device Write the current file on device in cpio (5) format (5120 byte records). 

-newer file True if the current file has been modified more recently than the argument file. 

( expression ) True if the parenthesized expression is true (parentheses are special to the shell and 

must be escaped). 

The primaries may be combined using the following operators (in order of decreasing precedence): 

1) The negation of a primary (! is the unary not operator). 

2) Concatenation of primaries (the and operation is implied by the juxtaposition of two primaries). 

3) Alternation of primaries (-o is the or operator). 

EXAMPLE 

To remove all files named a.out or *.o that have not been accessed for a week: 
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find / \( -name a.out -o -name '*.o' \) -atime +7 -exec rm {} \; 

FILES 

/etc/passwd, /etc/group 
SEE ALSO 

cpio(l), sh(l), test(l), stat(2), cpio(5), fs(5). 
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NAME 

fsck - file system consistency check and interactive repair 
SYNOPSIS 

/etc/fsck [ -y ] [ -n ] [ -sX ] [ -SX ] [ -t file ] [ file-system ]... 

DESCRIPTION 

Fsck audits and interactively repairs inconsistent conditions for UNIX file systems. If the file system is con¬ 
sistent then the number of files, number of blocks used, and number of blocks free are reported. If the file 
system is inconsistent the operator is prompted for concurrence before each correction is attempted. It 
should be noted that most corrective actions will result in some loss of data. The amount and severity of 
data lost may be determined from the diagnostic output. The default action for each consistency correction 
is to wait for the operator to respond yes or no. If the operator does not have write permission fsck will 
default to a -n action. 

Fsck has more consistency checks than its predecessors check, dcheck,/check, and icheck combined. 

The following flags are interpreted by fsck. 

-y Assume a yes response to all questions asked hy fsck. 

-n Assume a no response to all questions asked by fsck; do not open the file system for writing. 

-sX Ignore the actual free list and (unconditionally) reconstruct a new one by rewriting the super-block 

of the file system. The file system should be unmounted while this is done; if this is not possible, 
care should be taken that the system is quiescent and that it is rebooted immediately afterwards. 
This precaution is necessary so that the old, bad, in-core copy of the superblock will not continue to 
be used, or written on the file system. 

The -sX option allows for creating an optimal free-list organization. The following forms of X are 
supported for the following devices: 

-s3 (RP03) 

-s4 (RP04, RP05, RP06) 

-sBlocks-per-cylinder:Blocks-to-skip (for anything else) 

If X is not given, the values used when the file system was created are used. If these values were 
not specified, then the value 400:9 is used. 

-SX Conditionally reconstruct the free list. This option is like -sX above except that the free list is rebuilt 
only if there were no discrepancies discovered in the file system. Using -S will force a no response 
to all questions asked hy fsck. This option is useful for forcing free list reorganization on uncon¬ 
taminated file systems. 

-t If fsck cannot obtain enough memory to keep its tables, it uses a scratch file. If the -t option is 
specified, the file named in the next argument is used as the scratch file, if needed. Without the -t 
f[a.g, fsck will prompt the operator for the name of the scratch file. The file chosen should not be on 
the file system being checked, and if it is not a special file or did not already exist, it is removed 
when fsck completes. 

If no file-systems are specified,will read a list of default file systems from the file /etc/checklist. 
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Inconsistencies checked are as follows: 

1. Blocks claimed by more than one inode or the free list. 

2. Blocks claimed by an inode or the free list outside the range of the file system. 

3. Incorrect link counts. 

4. Size checks: 

Incorrect number of blocks. 

Directory size not 16-byte aligned. 

5. Bad inode format. 

6. Blocks not accounted for anywhere. 

7. Directory checks: 

File pointing to unallocated inode. 

Inode number out of range. 

8. Super Block checks: 

More than 65536 inodes. 

More blocks for inodes than there are in the file system. 

9. Bad free block list format. 

10. Total free block and/or free inode count incorrect. 

Orphaned files and directories (allocated but unreferenced) are, with the operator’s concurrence, recon¬ 
nected by placing them in the lost+found directory. The name assigned is the inode number. The only 
restriction is that the directory lost+found must preexist in the root of the file system being checked and 
must have empty slots in which entries can be made. This is accomplished by making lost+found, copying 
a number of files to the directory, and then removing them (before/ye/: is executed). 

Checking the raw device is almost always faster. 

FILES 

/etc/checklist contains default list of file systems to check. 

DIAGNOSTICS 

The diagnostics produced hy fsck are intended to be self-explanatory. 

SEE ALSO 

checklist(5), fs(5), crash(8). 

BUGS 

Inode numbers for . and .. in each directory should be checked for validity. 

-g and -b options from check should be available 'mfsek. 
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NAME 

fscv - convert files between PDP-11 and VAX-11/780 systems 

SYNOPSIS 

/etc/fscv -V ispecial [ ospecial ] 

/etc/fscv -p ispecial [ ospecial ] 

DESCRIPTION 

Fscv converts file systems between PDP-11 and VAX-11/780 formats. The super block, free list, and inodes 
are converted to the format of the output file. Fscv may be executed on PDP-11 and VAX processors. The 
mandatory flag specifies the format of the converted file system: 

-V Convert file system from PDP-11 to VAX format. 

-p Convert file system from VAX to PDP-11 format. 

Ispecial is the name of a special file containing a file system to be converted (e.g.; /dev/rrpl). The optional 
ospecial is the name of the special file to receive the results of the conversion. If ospecial is specified the 
entire contents of ispecial are copied to ospecial before the conversion is performed. If ospecial is not 
specified an in-place conversion of ispecial is performed. The following items should be noted before exe- 
cuting/9cv: 

1. A file system consistency check (fsck(lM)) should be performed on ispecial immediately prior to 
executing/^cv. 

2. Neither ispecial nor the optional ospecial should contain a mounted file system during execution of 
fscv. Modification to either the input or the output file system while/^cv is executing will probably 
corrupt the converted file system. 

3. A backup of ispecial (see volcopy(\M)) is highly recommended if an in-place conversion is to be 
performed. System crashes, I/O errors, etc., during execution of fscv may destroy the file system 
contained in ispecial. Also, if the optional ospecial is specified any data contained in that special 
file will be over written. 

4. If the optional ospecial is specified, this special file must be large enough to contain the entire con¬ 
tents of ispecial. See the appropriate special files in section 4. 

EXAMPLES 

Copy and convert a file system from PDP-11 to VAX format: 

/etc/fscv -V /dev/rrpO /dev/rrplO 
Perform an in-place conversion from VAX to PDP-11 format: 

/etc/fscv -p /dev/rrplO 

BUGS 

The boot block is not modified during conversion. The resulting file system will not be bootable. No data 
contained in the files of the file system are modified. 

SEE ALSO 

fsck(lM), volcopy(lM). 
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NAME 

fsdb - file system debugger 

SYNOPSIS 

/etc/fsdb special [ - ] 

DESCRIPTION 

Fsdb can be used to patch up a damaged file system after a crash. It has conversions to translate block and 
i-numbers into their corresponding disk addresses. Also included are mnemonic offsets to access different 
parts of an i-node. These greatly simplify the process of correcting control block entries or descending the 
file system tree. 

Fsdb contains several error checking routines to verify i-node and block addresses. These can be disabled 
if necessary by invokingwith the optional - argument or by the use of the O symbol. {Fsdb reads the 
i-size and f-size entries from the superblock of the file system as the basis for these checks.) 

Numbers are considered decimal by default. Octal numbers must be prefixed with a zero. During any 
assignment operation, numbers are checked for a possible truncation error due to a size mismatch between 
source and destination. 

Fsdb reads a block at a time and will therefore work with raw as well as block I/O. A buffer management 
routine is used to retain commonly used blocks of data in order to reduce the number of read system calls. 
All assignment operations result in an immediate write-through of the corresponding block. 

The symbols recognized hy fsdb are: 

# absolute address 

i convert from i-number to i-node address 

b convert to block address 

d directory slot offset 

-I-,- address arithmetic 

q quit 

>,< save, restore an address 

= numerical assignment 

=+ incremental assignment 

=- decremental assignment 

=" character string assignment 

O error checking flip flop 

p general print facilities 

f file print facility 

B byte mode 

W word mode 

D double word mode 

! escape to shell 

The print facilities generate a formatted output in various styles. The current address is normalized to an 
appropriate boundary before printing begins. It advances with the printing and is left at the address of the 
last item printed. The output can be terminated at any time by typing the delete character. If a number fol¬ 
lows the p symbol, that many entries are printed. A check is made to detect block boundary overflows 
since logically sequential blocks are generally not physically sequential. If a count of zero is used, all 
entries to the end of the current block are printed. The print options available are: 

i print as i-nodes 

d print as directories 

o print as octal words 

e print as decimal words 

c print as characters 

b print as octal bytes 
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The f symbol is used to print data blocks associated with the current i-node. If followed by a number, that 
block of the file is printed. (Blocks are numbered from zero.) The desired print option letter follows the 
block number, if present, or the f symbol. This print facility works for small as well as large files. It 
checks for special devices and that the block pointers used to find the data are not zero. 

Dots, tabs and spaces may be used as function delimiters but are not necessary. A line with just a new-line 
character will increment the current address by the size of the data type last printed. That is, the address is 
set to the next byte, word, double word, directory entry or i-node, allowing the user to step through a region 
of a file system. Information is printed in a format appropriate to the data type. Bytes, words and double 
words are displayed with the octal address followed by the value in octal and decimal. A .B or .D is 
appended to the address for byte and double word values, respectively. Directories are printed as a direc¬ 
tory slot offset followed by the decimal i-number and the character representation of the entry name. 
Inodes are printed with labeled fields describing each element. 

The following mnemonics are used for i-node examination and refer to the current working i-node: 

md mode 

In link count 

uid user ID number 

gid group ID number 

sO high byte of file size 

si low word of file size 

a# data block numbers (0 - 12) 

at access time 

mt modification time 

maj major device number 

min minor device number 


EXAMPLES 

386i 


prints i-number 386 in an i-node format. This now becomes the current working i- 
node. 


ln=4 

ln=-Hl 

fc 

2ifd 
d5i fc 


Ib.pOo 

2i.a0b.d7=3 

d7.nm="name" 


changes the link count for the working i-node to 4. 
increments the link count by 1. 

prints, in ASCII, block zero of the file associated with the working i-node, 
prints the first 32 directory entries for the root i-node of this file system. 

changes the current i-node to that associated with the 5th directory entry (numbered 
from zero) found from the above command. The first 512 bytes of the file are then 
printed in ASCII. 

prints the superblock of this file system in octal. 

changes the i-number for the seventh directory slot in the root directory to 3. This 
example also shows how several operations can be combined on one command line. 

changes the name field in the directory slot to the given string. Quotes are optional 
when used with nm if the first character is alphabetic. 


SEE ALSO 

fsck(lM), dir(5), fs(5). 
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NAME 

fsend - send files to the HONEYWELL 6000 
SYNOPSIS 

fsend [ options ] [ files ] 

DESCRIPTION 

Fsend arranges to have one or more UNIX files sent to HONEYWELL GCOS. GCOS identification must 
appear in the UNIX password file (see passwdiS)), or be supplied by the -i option. If no names appear, the 
standard input is sent; fsend may be used as a filter. 

Normally, the catalog on the HONEYWELL file system in which the new file will appear is the same as the 
UNIX login name of the person who issues the command. If, however, a user has a different name in the 
third field of the GCOS “idem card image” (which image is extracted from the UNIX password file; see 
passwd{5)), this name is taken as the GCOS catalog name. Whatever GCOS catalog is finally used, the user 
must have arranged that the user ID ‘ ‘network’ ’ has create permission on that catalog, or read and write per¬ 
mission on the individual files. The latter is more painful but preferred if access to other files in the catalog 
is to be fully controlled. This can be accomplished with the GCOS commands: 

filsys me <user ID>,(c)/network/ 
or 

filsys cf <file>,(r,w)/network/,b/<initial-size>,unlimited/ 

The name of the GCOS file is ordinarily the same as the name of the UNIX file. When the standard input is 
sent, the GCOS file is normally taken to be pipe.end. 

The following options, each as a separate argument, (or in the case of -u and -f, as two separate argu¬ 
ments), may appear in any order, but must precede all file name arguments. 

-a Send succeeding files as ASCII (default). If the last character of the file is not a new-line, one is 
added. All other characters are preserved. 

-b Send succeeding files as binary. Each UNIX byte is right justified in a GCOS byte and the bytes 
packed into 120-byte logical records (30 GCOS words). The last record is padded out with NULs. 
-c Make copies of the files to be sent before returning to the user. 

-r Remove the files after sending them. 

-f Use the next argument as the GCOS file name for the succeeding file. 

-i Supply the GCOS “ident card” image as the parameter -iMxxxx,Myyy where Mxxxx is the GCOS 
Job number and Myyy the GCOS bin number. 

-m When transmission is complete, report by mail{\.) the so-called snumb of the receiving GCOS job. 
The mail is sent by the UNIX daemon; there is no guarantee that the GCOS job ran successfully. 
This is the default option. 

-n Do not report the completion of transmission by mail{\). 

-o Print the on-line GCOS accounting output. 

-t Toss out the on-line GCOS accounting output. This is the default option. 

-sn Submit job to GCOS with service grade n (n=l, 2, 3). Default is -si. 

-u Use the next argument as the GCOS catalog name for all files. 

-X Send succeeding files to be archived by the GCOS archive command. 

EXAMPLE 

The command: 

fsend -t -u unixsup -b -f gfile ufile 

will send the binary UNIX file ufile to become the GCOS file unixsup/gfile, and will not produce any on¬ 
line GCOS accounting output. 

FILES 

/etc/passwd user’s identification and GCOS ident card. 

/usr/lib/dpd sending daemon. 
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/usr/spool/dpd/* spool area. 

SEE ALSO 

dpd(lC), dpr(lC), fget(lC), gcat(lC), mail(l). 
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NAME 

fwtmp, wtmpfix - manipulate wtmp records 

SYNOPSIS 

fwtmp [-ic] 
wtmpfix [files] 

DESCRIPTION 

Fwtmp 

Fwtmp reads from the standard input and writes to the standard output, converting binary records of the 
type found in wtmp to formated ASCII records. The ASCII version is useful to enable editing, via ed{l), 
bad records or general purpose maintenance of the file. 

The argument -ic is used to denote that input is in ASCII form, and output is to be written in binary form. 
Wtmpfix 

Wtmpfix examines the standard input or named files in wtmp format, corrects the time/date stamps to make 
the entries consistent, and writes to the standard output. A - can be used in place of files to indicate the 
standard input. If time/date corrections are not made, acctconl will fault when it encounters certain date 
change records. 

Each time the date is set while operating in multi-user mode, a pair of date change records are written to 
/usr/adm/wtmp. The first record is the old date denoted by I in the name field. The second record 
specifies the new date and is denoted by a {in the name field. Wtmpfix uses these records to synchronize all 
time stamps in the file. 

FILES 

/usr/adm/wtmp 
/usr/include/utmp h 

SEE ALSO 

acct(lM), acctcms(lM), acctcom(l), acctcon(lM), acctmerg(lM), acctprc(lM), acctsh(lM), runacct(lM), 
acct(2), acct(5), utmp(5). 
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NAME 

gcat - send phototypesetter output to the HONEYWELL 6000 
SYNOPSIS 

gcat [ options ] [ files ] 

DESCRIPTION 

Gcat arranges to have output sent to the phototypesetter or debugging devices (STARE or line 

printer) attached to the HONEYWELL system. GCOS identification must appear in the UNIX password file 
(see passwd(5)), or be supplied by the -i option. If no file name appears, the standard input is sent; thus 
gcat may be used as an output pipe for trqff(\). 

The option -g (for GCOS) must be used with the trqff(\) command to make things work properly. This 
command string sends output to the GCOS phototypesetter: 

troff -g file I gcat 

The following options, each as a separate argument, and in any combination (multiple outputs are permit¬ 
ted), may be given after gcat: 

-ph Send output to the phototypesetter. This is a default option. 

-st Send output to STARE for fast turn-around. 

-tx Send output as text to the line printer (useful for checking spelling, hyphenation, pagination, etc.), 

-du Send output to the line printer, dummied up to make the format correct. Because many characters 

are dropped, the output is unreadable, but useful for seeing the shape (margins, etc.) of the docu¬ 
ment. 

-c Make a copy of the file to be sent before returning to the user. 

-r Remove the file after sending it. 

-f Use the next argument as a dummy file name to report back in the mail. (This is useful for distin¬ 
guishing multiple runs, especially when gcat is being used as a filter). 

-i Supply the GCOS “idem card” image as the parameter -\Mxxxx,Myyy where Mxxxx is the GCOS 
job number and Myyy the GCOS bin number. 

-m When transmission is complete, report by mail(l) the so-called snumb of the receiving GCOS job. 
The mail is sent by the UNIX daemon; there is no guarantee that the GCOS job ran successfully. 
This is a default option. 

-n Do not report the completion of transmission by mail{\). 

-o Print the on-line GCOS accounting output. 

-t Toss out the on-line GCOS accounting output. This is a default option. 

-Srt Submit job to GCOS with service grade n (n=l, 2, 3). Default is -si. 

If none of the output options are specified, phototypesetter output (-ph) is assumed by default. 

EXAMPLE 

The command: 

troff -g myfile I gcat -st -iml234,m567,myname -f myfile 

will send the output of trojf{\) to STARE, with the GCOS “idem card” specifying 
“M1234,M567,MYNAME’’, and will report back that myfile has been sent. 

FILES 

/etc/passwd user’s identification and GCOS idem card. 

/usr/lib/dpd sending daemon. 

/usr/spool/dpd/* spool area. 

SEE ALSO 

dpd(lC), dpr(lC), fget(lC), fsend(lC), troff(l). 
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NAME 

gcosmail - send mail to HIS user 
SYNOPSIS 

gcosmail [ option ... ] [ HISuserid ... ] 

DESCRIPTION 

Gcosmail takes the standard input up to an end of file and sends it as mail to the named users on the 
HONEYWELL 6000 system, using the HIS mail command. The following options are recognized by 
gcosmail: 

-f Use the next argument as a dummy file name to report back in the mail. (This is useful for distin¬ 
guishing multiple runs). 

-i Supply the GCOS “idem card” image as the parameter -\Mxxxx,Myyy where Mxxxx is the GCOS 
job number and Myyy is the GCOS bin number. 

-m When transmission is complete, report by mail{\) the so-called snumb of the receiving GCOS job. 
The mail is sent by the UNIX daemon; there is no guarantee that the GCOS job ran successfully. 
This is a default option. 

-n Do not report the completion of transmission by mail{\.). 

-o Print the on-line GCOS accounting output. 

-t Toss out the on-line GCOS accounting output. This is a default option. 

-Srt Submit job to GCOS with service grade n (n=l, 2, 3). Default is -si. 

FILES 

/etc/passwd user’s identification and GCOS idem card. 

/usr/lib/dpd sending daemon. 

/usr/spool/dpd/* spool area. 

SEE ALSO 

dpd(lC), dpr(lC), fsend(lC). 
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NAME 

hpd, erase, hardcopy, tekset, td - graphical device routines and filters 
SYNOPSIS 

hpd [-options] [GPS file ...] 

erase 

hardcopy 

tekset 

td [-eurn] [GPS file ...] 

DESCRIPTION 

All of the commands described below reside in /usr/bin/graf (see graphics{lG)). 

hpd Hpd translates a GPS (see gps{5)), to instructions for the Hewlett-Packard 7221A Graphics 

Plotter. A viewing window is computed from the maximum and minimum points 'mfile unless 
the -u or -r option is provided. If no file is given, the standard input is assumed. Options are: 

cn Select character set n, n between 0 and 5 (see the HP7221A Plotter Operating and 
Programming Manual, Appendix A). 

pn Select pen numbered n, n between 1 and 4 inclusive. 
rn Window on GPS region n, n between 1 and 25 inclusive. 
sn Slant characters n degrees clockwise from the vertical, 
u Window on the entire GPS universe. 

xdrt Set X displacement of the viewport’s lower left corner to n inches. 

\vn Set width of viewport to n inches. 

yd« Set y displacement of the viewport’s lower left comer to n inches. 
yvn Set height of viewport to n inches. 

erase Erase sends characters to a Tektronix 4010 series storage terminal to erase the screen. 

hardcopy When issued at a Tektronix display terminal with a hard copy unit, hardcopy generates a screen 
copy on the unit. 

tekset Tekset sends characters to a Tektronix terminal to clear the display screen, set the display mode 
to alpha, and set characters to the smallest font. 

td Td translates a GPS to scope code for a Tektronix 4010 series storage terminal. A viewing win¬ 

dow is computed from the maximum and minimum points in file unless the -u or -r option is 
provided. If no is given, the standard input is assumed. Options are: 

e Do not erase screen before initiating display. 
rn Display GPS region n, n between 1 and 25 inclusive, 
u Display the entire GPS universe. 

SEE ALSO 

graphics(lG), ged(lG), gps(5). 
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NAME 

ged - graphical editor 
SYNOPSIS 

ged [-euRrn] [GPS file ...] 

DESCRIPTION 

Ged is an interactive graphical editor used to display, construct, and edit GPS files on Tektronix 4010 series 
display terminals. If GPS filers) are given, ged reads them into an internal display buffer and displays the 
buffer. The GPS in the buffer can then be edited. If - is given as a file name, ged reads a GPS from the 
standard input. 

Ged accepts the following command line options: 

e Do not erase the screen before the initial display. 
rn Display region number n. 

u Display the entire GPS universe. 

R Restricted shell invoked on use of!. 

A GPS file is composed of instances of three graphical objects: lines, arc, and text. Arc and lines objects 
have a start point, or object-handle, followed by zero or more points, or point-handles. Text has only an 
object-handle. The objects are positioned within a Cartesian plane, or universe, having 64K (-32K to 
-I-SIK) points, or universe-units, on each axis. The universe is divided into 25 equal sized areas called 
regions. Regions are arranged in five rows of five squares each, numbered 1 to 25 from the lower left of the 
universe to the upper right. 

Ged maps rectangular areas, called windows, from the universe onto the display screen. Windows allow the 
user to view pictures from different locations and at different magnifications. The universe-window is the 
window with minimum magnification, i.e. the window that views the entire universe. The home-window is 
the window that completely displays the contents of the display buffer. 

COMMANDS 

Ged commands are entered in stages. Typically each stage ends with a <cr> (return). Prior to the final 
<cr> the command may be aborted by typing rubout. The input of a stage may be edited during the stage 
using the erase and kill characters of the calling shell. The prompt * indicates that ged is waiting at stage 1. 

Each command consists of a subset of the following stages: 

1. Command line 

A command line consists of a command name followed by argument{&) followed by a <cr>. 
A command name is a single character. Command arguments are either option(s) or a. file¬ 
name. Options are indicated by a leading -. 

2. Text Text is a sequence of characters terminated by an unescaped <cr>. (120 lines of text maxi¬ 

mum.) 

3. Points Points is a sequence of one or more screen locations (maximum of 30) indicated either by 

the terminal crosshairs or by name. The prompt for entering points is the appearance of the 
crosshairs. When the crosshairs are visible, typing: 

sp (space) enters the current location as a point. The point is identified with a number. 

$n enters the previous point numbered n. 

>x labels the last point entered with the upper case letter x. 

$x enters the point labeled Jt. 

. establishes the previous points as the current points. At the start of a command the 
previous points are those locations given with the previous command. 
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= 

echoes the current points. 


$.n 

enters the point numbered n from the previous points. 


# 

erases the last point entered. 


@ 

erases all of the points entered. 

4. Pivot 

The pivot is a single location, entered by typing <cr> or by using the $ operator, and indi¬ 
cated with a *. 

5. Destination 



The destination is a single location entered by typing <cr> or by using $. 


COMMAND SUMMARY 

In the summary, characters typed by the user are printed in bold. Command stages are printed in italics. 
Arguments surrounded by brackets are optional. Parentheses “()” surrounding arguments separated 
by “or” means that exactly one of the arguments must be given. 


Construct commands: 
Arc 

Box 

Circle 

Hardware 

Lines 

Text 


[-echo,style,weight] points 
[-echo,style,weight] points 
[-echo,style,weight] points 
[-echo] text points 
[-echo,style,weight] points 

[-angle,echo,height,mid-point,right-point,text,weight] text points 


Edit commands: 

Delete 

Edit 

Kopy 

Move 

Rotate 

Scale 


( - (universe or view) or points ) 

[-angle,echo,height,style, weight] (- (universe or view) or points ) 
[-echo,points,x] points pivot destination 
[-echo,points,x] points pivot destination 
[-angle,echo,kopy,x] points pivot destination 
[-echo,factor,kopy,x] points pivot destination 


View commands: 

coordinates 

erase 

new-display 

object-handles 

point-handles 

view 

X 

zoom 


points 


(- (universe or view) or points ) 

(- (labelled-points or universe or view) or points ) 

(- (home or universe or region) or [-x] pivot destination ) 
[-view] points 
[-out] points 


Other commands: 

quit or Quit 
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read [-angle,echo,height,mid-point,right-point,text,weight] [destination] 

set [-angle,echo,factor,height,kopy,mid-point,points, right-point,style,text,weight,x] 

write file-name 

Icommand 

9 


Options: 

Options specify parameters used to construct, edit, and view graphical objects. If a parameter used by a 
command is not specifed as an option, the default value for the parameter will be used (see set below). The 
format of command options is 
-option [,option ] 

where option is keyietter[value]. Flags take on the values of true or false indicated by + and - respectively. 
If no value is given with a flag, true is assumed. 


Object options: 
anglen 
echo 
factors 
heights 
kopy 
mid-point 
points 
right-point 
siylQtype 


text 

weight/ype 


Area options: 
home 
out 

regions 

universe 

view 

X 


Angle of n degrees. 

When true, echo additions to the display buffer. 

Scale factor is n percent. 

Height of text is n universe-units (0<n< 1280). 

When true, copy rather than move. 

When true, mid-point is used to locate text string. 

When true, operate on points otherwise operate on objects. 

When true, right-point is used to locate text string. 

Line style set to one of following types : 
so solid 

da dashed 

dd dot-dashed 

do dotted 

Id long-dashed 

When false, text strings are outlined rather than drawn. 

Sets line weight to one of following types: 
n narrow 

m medium 

b bold 

Reference the home-window. 

Reduce magnification. 

Reference region n. 

Reference the uni verse-window. 

Reference those objects currently in view. 

Indicate the center of the referenced area. 


COMMAND DESCRIPTIONS 
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Construct commands: 

Arc and Lines 

behave similarly. Each consists of a command line followed by points. The first point entered is the 
object-handle. Successive points are point-handles. Lines connects the handles in numerical order. 
Arc fits a curve to the handles (currently a maximum of 3 points will be fit with a circular arc; splines 
will be added in a later version). 

Box and Circle 

are special cases of Lines and Arc, respectively. Box generates a rectangle with sides parallel to the 
universe axes. A diagonal of the rectangle would connect the first point entered with the last point. 
The first point is the object-handle. Point-handles are created at each of the vertices. Circle gener¬ 
ates a circular arc centered about the point numbered zero and passing through the last point. The 
circle’s object-handle coincides with the last point. A point-handle is generated 180 degrees around 
the circle from the object-handle. 

Text and Hardware 

generate text objects. Each consists of a command line, text and points. Text is a sequence of char¬ 
acters delimited by <cr>. Multiple lines of text may be entered by preceding a cr with a backslash 
(i.e. \cr). The Text command creates software generated characters. Each line of software text is 
treated as a separate text object. The first point entered is the object-handle for the first line of text. 
The Hardware command sends the characters in text uninterpreted to the terminal. 


Edit commands: 

Edit commands operate on portions of the display buffer called dejined-areas. A defined-area is referenced 
either with an area option or interactively. If an area option is not given, the perimeter of the defined-area is 
indicated by points. If no point is entered, a small defined-area is built around the location of the <cr>. 
This is useful to reference a single point. If only one point is entered, the location of the <cr> is taken in 
conjunction with the point to indicate a diagonal of a rectangle. A defined-area referenced by points will be 
outlined with dotted lines. 

Delete 

removes all objects whose object-handle lies within a defined-area. The universe option removes all 
objects and erases the screen. 

Edit modifies the parameters of the objects within a defined-area. Parameters that can be edited are: 
angle angle of text 
height height of text 
style style of lines and arc 
weight weight of lines, arc, and text. 

Kopy (or Move) 

copies (or moves) object- and/or point-handles within a defined-area by the displacement from the 
pivot to the destination. 

Rotate 

rotates objects within a defined-area around the pivot. If the kopy flag is true then the objects are 
copied rather than moved. 

Scale For objects whose object-handles are within a defined-area, point displacements from the pivot are 
scaled by factor percent. If the kopy flag is true then the objects are copied rather than moved. 


View commands: 
coordinates 

prints the location of point(s) in universe- and screen-units, 
erase clears the screen (but not the display buffer). 
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new-display 

erases the screen then displays the display buffer, 
object-handles (or point-handles) 

labels object- (and/or point-handles) that lie within the defined-area with O (or P). point-handles 
identifies labelled points when the labelled-points flag is true. 

view moves the window so that the universe point corresponding to the pivot coincides with the screen 
point corresponding to the destination. Options for home, universe, and region display particular 
windows in the universe. 

X indicates the center of a defined-area. Option view indicates the center of the screen, 
zoom 

decreases (zoom out) or increases the magnification of the viewing window based on the defined- 
area. For increased magnification, the window is set to circumscribe the defined-area. For a decrease 
in magnification the current window is inscribed within the defined-area. 


Other commands: 
quit or Quit 

exit from ged. quit responds with ? if the display buffer has not been written since the last 
modification. 

read inputs the contents of a file. If the file contains a GPS it is read directly. If the file contains text it is 
converted into text object(s). The first line of a text file begins at destination. 

set when given option(s) resets default parameters, otherwise it prints current default values, 
write outputs the contents of the display buffer to a file. 

! escapes ged to execute a UNIX command. 

? lists ged commands. 

SEE ALSO 

graphics(lG), gdev(lG), rsh(l), gps(5). 

A Tutorial Introduction to the Graphical Editor by A. R. Feuer. 
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NAME 

get - get a version of an SCCS file 
SYNOPSIS 

get [-rSID] [-ccutoff] [-ilist] [-xlist] [-aseq-no.] [-k] [-e] [-l[p]] [-p] [-m] [-n] [-s] [-b] [-g] [-t] file 


DESCRIPTION 

Get generates an ASCII text file from each named SCCS file according to the specifications given by its 
keyletter arguments, which begin with The arguments may be specified in any order, but all keyletter 
arguments apply to all named SCCS files. If a directory is named, get behaves as though each file in the 
directory were specified as a named file, except that non-SCCS files (last component of the path name does 
not begin with s.) and unreadable files are silently ignored. If a name of - is given, the standard input is 
read; each line of the standard input is taken to be the name of an SCCS file to be processed. Again, non- 
SCCS files and unreadable files are silently ignored. 

The generated text is normally written into a file called the g-file whose name is derived from the SCCS file 
name by simply removing the leading s.; (see also FILES, below). 

Each of the keyletter arguments is explained below as though only one SCCS file is to be processed, but the 
effects of any keyletter argument applies independently to each named file. 

-rSID The 5CCS /Dentification string (SID) of the version (delta) of an SCCS file to be retrieved. 

Table 1 below shows, for the most useful cases, what version of an SCCS file is retrieved (as 
well as the SID of the version to be eventually created by delta{\) if the -e keyletter is also 
used), as a function of the SID specified. 

-ccutoff Cutoff date-time, in the form: 

YY[MM[DD[HH[MM[SS]]]]] 

No changes (deltas) to the SCCS file which were created after the specified cutoff date-time are 
included in the generated ASCII text file. Units omitted from the date-time default to their maxi¬ 
mum possible values; that is, -c7502 is equivalent to -c750228235959. Any number of non¬ 
numeric characters may separate the various 2 digit pieces of the date-time. This feature 
allows one to specify a cutoff date in the form: ”-c77/2/2 9:22:25". Note that this implies that 
one may use the %E% and %U% identification keywords (see below) for nested gets within, say 
the input to a send(\C) command: 

'!get "-c%E% %U%" s.file 

-e Indicates that the get is for the purpose of editing or making a change (delta) to the SCCS file via 

a subsequent use of della{l). The -e keyletter used in a get for a particular version (SID) of the 
SCCS file prevents further gets for editing on the same SID until delta is executed or the j (joint 
edit) flag is set in the SCCS file (see admm(l)). Concurrent use of get -e for different SIDs is 
always allowed. 

If the g-file generated by get with an -e keyletter is accidentally ruined in the process of editing 
it, it may be regenerated by re-executing the get command with the -k keyletter in place of the 
-e keyletter. 

SCCS file protection specified via the ceiling, floor, and authorized user list stored in the SCCS 
file (see adminii)) are enforced when the -e keyletter is used. 

-b Used with the -e keyletter to indicate that the new delta should have an SID in a new branch as 

shown in Table 1. This keyletter is ignored if the b flag is not present in the file (see adminii)) 
or if the retrieved delta is not a leaf delta. (A leaf delta is one that has no successors on the 
SCCS file tree.) 

Note: A branch delta may always be created from a non-leaf delta. 

-ilist A list of deltas to be included (forced to be applied) in the creation of the generated file. The list 
has the following syntax: 
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<list> ::= <range> | <list> , <range> 

<range> ::= SID | SID - SID 

SID, the sees Identification of a delta, may be in any form shown in the “SID Specified” col¬ 
umn of Table 1. Partial SIDs are interpreted as shown in the “SID Retrieved” column of 
Table 1. 

-xlist A list of deltas to be excluded (forced not to be applied) in the creation of the generated file. See 
the -i keyletter for the list format. 

-k Suppresses replacement of identification keywords (see below) in the retrieved text by their 

value. The -k keyletter is implied by the -e keyletter. 

-l[p] Causes a delta summary to be written into an l-file. If -Ip is used then an l-file is not created; the 
delta summary is written on the standard output instead. See FILES for the format of the l-file. 

-p Causes the text retrieved from the SCCS file to be written on the standard output. No g-file is 

created. All output which normally goes to the standard output goes to file descriptor 2 instead, 
unless the -s keyletter is used, in which case it disappears. 

-s Suppresses all output normally written on the standard output. However, fatal error messages 

(which always go to file descriptor 2) remain unaffected. 

-m Causes each text line retrieved from the SCCS file to be preceded by the SID of the delta that 

inserted the text line in the SCCS file. The format is: SID, followed by a horizontal tab, followed 
by the text line. 

-n Causes each generated text line to be preceded with the %M% identification keyword value (see 

below). The format is: %M% value, followed by a horizontal tab, followed by the text line. 
When both the -m and -n keyletters are used, the format is: %M% value, followed by a horizon¬ 
tal tab, followed by the -m keyletter generated format. 

-g Suppresses the actual retrieval of text from the SCCS file. It is primarily used to generate an /- 

file, or to verify the existence of a particular SID. 

-t Used to access the most recently created (“top”) delta in a given release (e.g., -rl), or release 

and level (e.g., -rl.2). 

-aseq-no. The delta sequence number of the SCCS file delta (version) to be retrieved (see sccsfile(5)). This 
keyletter is used by the comb(l) command; it is not a generally useful keyletter, and users 
should not use it. If both the -r and -a keyletters are specified, the -a keyletter is used. Care 
should be taken when using the -a keyletter in conjunction with the -e keyletter, as the SID of 
the delta to be created may not be what one expects. The -r keyletter can be used with the -a 
and -e keyletters to control the naming of the SID of the delta to be created. 

For each file processed, get responds (on the standard output) with the SID being accessed and with the 
number of lines retrieved from the SCCS file. 

If the -e keyletter is used, the SID of the delta to be made appears after the SID accessed and before the 
number of lines generated. If there is more than one named file or if a directory or standard input is named, 
each file name is printed (preceded by a new-line) before it is processed. If the -i keyletter is used included 
deltas are listed following the notation “Included”; if the -x keyletter is used, excluded deltas are listed 
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following the notation “Excluded”. 

center expand ; c s s s s cl cl cl cl cO c c c c c 1 c 111. TABLE 1. Determination of SCCS Identification String 
= SlD^i^ -b Keyletter Other SID SID of Delta 

Specified Usedf Conditions Retrieved to be Created 

= nonet no R defaults to mR mR.mL mR.(mL+l) _ nonet yes R defaults to 
mR mR mL mR mL.(mB + l).l 

= R no R > mR mR.mL R.l*** _ R no R = mR mR mL mR.(mL+l) _ 

R yes R > mR mR.mL mR.mL.(mB + l).l _ R yes R = mR mR.mL mR.mL.(mB + l).l _ 
R - R < mR and hRmL** hR mL.(mB + l).l R does not 

exist _ R - Trunk succ.# R mL RmL.(mB + l).l in release > 

R and R exists 

= R.L no No trunk succ. R.L R.(L+1) _ R.L yes No trunk 

succ. R.L R.L.(mB + l).l _ R.L - Trunk succ. R.L R.L.(mB + l).l in 

release > R 

= R.L.B no No branch succ. R.L.B.mS R.L.B.(mS + l) _ R.L.B yes No branch 

succ. R.L.B.mS R.L.(mB+l).l 

= R.L.B.S no No branch succ. R.L.B.S R.L.B.(S+1) _ R.L.B.S yes No branch 

succ. R.L.B.S R.L.(mB+l).l R.L.B.S - Branch succ. R.L.B.S R.L.(mB + l).l 

* “R”, “L”, “B”, and “S” are the “release”, “level”, “branch”, and “sequence” components of 
the SID, respectively; “m” means “maximum”. Thus, for example, “R.mL” means “the maximum 
level number within release R”; “R.L.(mB+l).l” means “the first sequence number on the new 
branch (i.e., maximum branch number plus one) of level L within release R”. Note that if the SID 
specified is of the form “R.L”, “R.L.B”, or “R.L.B.S”, each of the specified components must 
exist. 

** ‘ ‘hR’ ’ is the highest existing release that is lower than the specified, nonexistent, release R. 

*** This is used to force creation of the first delta in a new release. 

# Successor. 

t The -b keyletter is effective only if the b flag (see admin{\.)) is present in the file. An entry of - 
means “irrelevant”. 

$ This case applies if the d (default SID) flag is not present in the file. If the d flag is present in the file, 
then the SID obtained from the d flag is interpreted as if it had been specified on the command line. 
Thus, one of the other cases in this table applies. 

IDENTIFICATION KEYWORDS 

Identifying information is inserted into the text retrieved from the SCCS file by replacing identification 
keywords with their value wherever they occur. The following keywords may be used in the text stored in 
an SCCS file: 

Keyword Value 

%M% Module name: either the value of the m flag in the file (see admin(\)), or if absent, the name of 
the SCCS file with the leading s. removed. 

%l% SCCS identification (SID) (%R%.%L%.%B%.%S%) of the retrieved text. 

%R% Release. 

%L% Level. 

%B% Branch. 

%S% Sequence. 

%D% Current date (YY/MM/DD). 

%H% Current date (MM/DD/YY). 

%T% Current time (HH:MM:SS). 

%E% Date newest applied delta was created (YY/MM/DD). 

%G% Date newest applied delta was created (MM/DD/YY). 



GET(l) 


GET(l) 


%U% Time newest applied delta was created (HH;MM:SS). 

%Y% Module type: value of the t flag in the SCCS file (see admin{\)). 

%F% SCCS file name. 

%P% Fully qualified SCCS file name. 

%Q% The value of the q flag in the file (see admm(l)). 

%C% Current line number. This keyword is intended for identifying messages output by the program 
such as “this shouldn’t have happened” type errors. It is not intended to be used on every line 
to provide sequence numbers. 

The 4-character string @(#) recognizable by what{\). 

A shorthand notation for constructing w>hat{\) strings for UNIX program files. 
%W% = %Z%%M%<horizontal-tab>%I% 

%A% Another shorthand notation for constructing what{\) strings for non-UNIX program files. 

%A% = %Z%%Y% %M% %I%%Z% 

FILES 

Several auxiliary files may be created by get. These files are known generically as the g-file, Ufile, p-file, 
and z-file. The letter before the hyphen is called the tag. An auxiliary file name is formed from the SCCS 
file name: the last component of all SCCS file names must be of the form s.module-name, the auxiliary files 
are named by replacing the leading s with the tag. The g-file is an exception to this scheme: the g-file is 
named by removing the s. prefix. For example, s.xyz.c, the auxiliary file names would be xyz.c, l.xyz.c, 
p.xyz.c, and z.xyz.c, respectively. 

The g-file, which contains the generated text, is created in the current directory (unless the -p keyletter is 
used). A g-file is created in all cases, whether or not any lines of text were generated by the get. It is 
owned by the real user. If the -k keyletter is used or implied its mode is 644; otherwise its mode is 444. 
Only the real user need have write permission in the current directory. 

The l-file contains a table showing which deltas were applied in generating the retrieved text. The l-file is 
created in the current directory if the -1 keyletter is used; its mode is 444 and it is owned by the real user. 
Only the real user need have write permission in the current directory. 

Lines in the l-file have the following format: 

a. A blank character if the delta was applied; 

* otherwise. 

b. A blank character if the delta was applied or wasn’t applied and ignored; 

* if the delta wasn’t applied and wasn’t ignored. 

c. A code indicating a “special” reason why the delta was or was not applied: 

“I”: Included. 

“X”: Excluded. 

“C”: Cut off (by a -c keyletter). 

d. Blank. 

e. SCCS identification (SID). 

f. Tab character. 

g. Date and time (in the form YY/MM/DD HH;MM:SS) of creation. 

h. Blank. 

i. Login name of person who created delta. 

The comments and MR data follow on subsequent lines, indented one horizontal tab character. A 
blank line terminates each entry. 

The p-file is used to pass information resulting from a get with an -e keyletter along to delta. Its contents 
are also used to prevent a subsequent execution of get with an -e keyletter for the same SID until delta is 
executed or the joint edit flag, j, (see adminifi)) is set in the SCCS file. The p-file is created in the directory 
containing the SCCS file and the effective user must have write permission in that directory. Its mode is 
644 and it is owned by the effective user. The format of the p-file is: the gotten SID, followed by a blank, 
followed by the SID that the new delta will have when it is made, followed by a blank, followed by the 
login name of the real user, followed by a blank, followed by the date-time the get was executed, followed 
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by a blank and the -i keyletter argument if it was present, followed by a blank and the -x keyletter argu¬ 
ment if it was present, followed by a new-line. There can be an arbitrary number of lines in the p-file at any 
time; no two lines can have the same new delta SID. 

The z-file serves as a lock-out mechanism against simultaneous updates. Its contents are the binary (2 
bytes) process ID of the command (i.e., get) that created it. The z-file is created in the directory containing 
the sees file for the duration of get. The same protection restrictions as those for the p-file apply for the 
z-file. The z-file is created mode 444. 

SEE ALSO 

admin(l), delta(l), help(l), prs(l), what(l), sccsfile(5). 

Source Code Control System User’s Guide by L. E. Bonanni and C. A. Salemi. 

DIAGNOSTICS 

Use helpil) for explanations. 

BUGS 

If the effective user has write permission (either explicitly or implicitly) in the directory containing the 
sees files, but the real user doesn’t, then only one file may be named when the -e keyletter is used. 
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NAME 

getopt - parse command options 
SYNOPSIS 

set — ' getopt optstring $*' 

DESCRIPTION 

Getopt is used to break up options in command lines for easy parsing by shell procedures, and to check for 
legal options. Optstring is a string of recognized option letters (see getopt(3C)); if a letter is followed by a 
colon, the option is expected to have an argument which may or may not be separated from it by white 
space. The special option — is used to delimit the end of the options. Getopt will place — in the argu¬ 
ments at the end of the options, or recognize it if used explicitly. The shell arguments ($1 $2 . . .) are reset 
so that each option is preceded by a - and in its own shell argument; each option argument is also in its own 
shell argument. 

DIAGNOSTICS 

Getopt prints an error message on the standard error when it encounters an option letter not included in 
optstring. 

EXAMPLE 

The following code fragment shows how one might process the arguments for a command that can take the 
options a and b, and the option o, which requires an argument. 

set — ^getopt abo: $*' 

if [ $? != 0 ] 

then 

echo $USAGE 
exit 2 
fi 

for i in $* 
do 

case $i in 

-a I -b)FLAG=$i; shift;; 

-o) OARG=$2; shift; shift;; 

—) shift; break;; 

esac 

done 

This code will accept any of the following as equivalent: 

cmd -aoarg file file 
cmd -a -o arg file file 
cmd -oarg -a file file 
cmd -a -oarg — file file 

SEE ALSO 

sh(l), getopt(3C). 
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NAME 

graph - draw a graph 

SYNOPSIS 

graph [ options ] 

DESCRIPTION 

Graph with no options takes pairs of numbers from the standard input as abscissas and ordinates of a graph. 
Successive points are connected by straight lines. The graph is encoded on the standard output for display 
by the tplot{\G) filters. 

If the coordinates of a point are followed by a non-numeric string, that string is printed as a label beginning 
on the point. Labels may be surrounded with quotes ", in which case they may be empty or contain blanks 
and numbers; labels never contain new-lines. 

The following options are recognized, each as a separate argument: 

-a Supply abscissas automatically (they are missing from the input); spacing is given by the next 

argument (default 1). A second optional argument is the starting point for automatic abscissas 
(default 0 or lower limit given by -x). 

-b Break (disconnect) the graph after each label in the input. 

-c Character string given by next argument is default label for each point. 

-g Next argument is grid style, 0 no grid, 1 frame with ticks, 2 full grid (default). 

-1 Next argument is label for graph. 

-m Next argument is mode (style) of connecting lines: 0 disconnected, 1 connected (default). 

Some devices give distinguishable line styles for other small integers (e.g., the Tektronix 4014: 
2=dotted, 3=dash-dot, 4=short-dash, 5=long-dash). 

-s Save screen, don’t erase before plotting. 

-X [ I ] If 1 is present, x axis is logarithmic. Next 1 (or 2) arguments are lower (and upper) x limits. 

Third argument, if present, is grid spacing on x axis. Normally these quantities are determined 
automatically. 

-y [ I ] Similarly for y. 

-h Next argument is fraction of space for height. 

-w Similarly for width. 

-r Next argument is fraction of space to move right before plotting. 

-u Similarly to move up before plotting. 

-t Transpose horizontal and vertical axes. (Option -x now applies to the vertical axis.) 

A legend indicating grid range is produced with a grid unless the -s option is present. If a specified lower 
limit exceeds the upper limit, the axis is reversed. 

SEE ALSO 

graphics(lG), spline(lG), tplot(lG). 

BUGS 

Graph stores all points internally and drops those for which there isn’t room. 

Segments that run out of bounds are dropped, not windowed. 

Logarithmic axes may not be reversed. 
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NAME 

graphics - access graphical and numerical commands 

SYNOPSIS 

graphics [ -r ] 

DESCRIPTION 

Graphics appends the path name /usr/bin/graf to the current $PATH value, changes the primary shell 
prompt to and executes a new shell. The directory /usr/bin/graf contains all of the Graphics subsystem 
commands. If the -r option is given, access to the graphical commands is created in a restricted environ¬ 
ment; that is, $PATH is set to /:rbin:/usr/rbin:/bin:/usr/bin:/usr/bin/graf and the restricted shell, rsh(l), 
is invoked. To restore the environment that existed prior to issuing the graphics command, type EOT 
(control-d on most terminals). To logoff from the graphics environment, type quit. 

The command line format for a command in graphics is command name followed by argument{^). An 
argument may be Q.file name or an option string. A file name is the name of any UNIX file except those 
beginning with -. The file name - is the name for the standard input. An option string consists of - fol¬ 
lowed by one or more option(s). An option consists of a keyletter possibly followed by a value. Options 
may be separated by commas. 

The graphical commands have been partitioned into four groups. 

Commands that manipulate and plot numerical data; see stat(\G). 

Commands that generate tables of contents; see toc{\G). 

Commands that interact with graphical devices; see gdev{lG) and ged{lG). 

A collection of graphical utility commands; see gutilGG). 

A list of the graphics commands can be generated by typing whatis in the graphics environment. 

SEE ALSO 

gdev(lG), ged(lG), gutil(lG), stat(lG), toc(lG), gps(5). 

UNIX Graphics Overview by A. R. Feuer. 

Administrative Information for the UNIX Graphics Package by R. L. Chen, D. E. Pinkston, and A. Guyton. 
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NAME 

greek - select terminal filter 

SYNOPSIS 

greek [ -Tterminal ] 

DESCRIPTION 

Greek is a filter that reinterprets the extended character set, as well as the reverse and half-line motions, of a 
128-character TELETYPE.nh 

Model 37 terminal (which is the nroffiV) default terminal) for certain other terminals. Special characters 
are simulated by overstriking, if necessary and possible. If the argument is omitted, greek attempts to use 
the environment variable $TERM (see environij)). The following terminals, are recognized currently: 


300 

DASI 300. 

300-12 

DASI 300 in 12-pitch. 

300s 

DASI 300s. 

300s-12 

DASI 300s in 12-pitch. 

450 

DASI 450. 

450-12 

DASI 450 in 12-pitch. 

1620 

Diablo 1620 (alias DASI 450). 

1620-12 

Diablo 1620 (alias DASI 450) in 12-pitch. 

2621 

Hewlett-Packard 2621, 2640, and 2645. 

2640 

Hewlett-Packard 2621, 2640, and 2645. 

2645 

Hewlett-Packard 2621, 2640, and 2645. 

4014 

Tektronix 4014. 

hp 

Hewlett-Packard 2621, 2640, and 2645. 

tek 

Tektronix 4014. 


EILES 

/usr/bin/300 

/usr/bin/300s 

/usr/bin/4014 

/usr/bin/450 

/usr/bin/hp 

SEE ALSO 

300(1), 300s(l), 4014(1), 450(1), eqn(l), greek(7), hp(l), mm(l), nroff(l), tplot(lG), environ(7), term(7). 
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NAME 

grep, egrep, fgrep - search a file for a pattern 
SYNOPSIS 

grep [ options ] expression [ files ] 
egrep [ options ] [ expression ] [ files ] 
fgrep [ options ] [ strings ] [ files ] 

DESCRIPTION 

Commands of the grep family search the input files (standard input default) for lines matching a pattern. 
Normally, each line found is copied to the standard output. Grep patterns are limited regular expressions in 
the style of ed{l); it uses a compact non-deterministic algorithm. Egrep patterns are full regular 
expressions; it uses a fast deterministic algorithm that sometimes needs exponential space. Fgrep patterns 
are fixed strings; it is fast and compact. The following options are recognized: 

-V All lines but those matching are printed. 

-X (Exact) only lines matched in their entirety are printed (fgrep only). 

-c Only a count of matching lines is printed. 

-I Only the names of files with matching lines are listed (once), separated by new-lines. 

-n Each line is preceded by its relative line number in the file. 

-b Each line is preceded by the block number on which it was found. This is sometimes useful in 
locating disk block numbers by context. 

-s The error messages produced for nonexistent or unreadable files are suppressed (grep only). 

-e expression 

Same as a simple expression argument, but useful when the expression begins with a - (does not 
work with grep). 

—ifile ThQrtgvXox expression (egrep) ox strings list (/gr^T?) is taken from the 

In all cases, the file name is output if there is more than one input file. Care should be taken when using the 
characters $, *, I, (,), and \ in expression, because they are also meaningful to the shell. It is safest to 
enclose the entire expression argument in single quotes 

Fgrep searches for lines that contain one of the strings separated by new-lines. 

Egrep accepts regular expressions as in ed(\.), except for \( and \), with the addition of: 

1. A regular expression followed by + matches one or more occurrences of the regular expression. 

2. A regular expression followed by ? matches 0 or 1 occurrences of the regular expression. 

3. Two regular expressions separated by I or by a new-line match strings that are matched by either. 

4. A regular expression may be enclosed in parentheses () for grouping. 

The order of precedence of operators is [ ], then * ? +, then concatenation, then I and new-line. 

SEE ALSO 

ed(l), sed(l), sh(l). 

DIAGNOSTICS 

Exit status is 0 if any matches are found, 1 if none, 2 for syntax errors or inaccessible files. 

BUGS 

Ideally there should be only one grep, but we don’t know a single algorithm that spans a wide enough 
range of space-time tradeoffs. 

Lines are limited to 256 characters; longer lines are truncated. 

Egrep does not recognize ranges, such as [a-z], in character classes. 
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NAME 

help - ask for help 

SYNOPSIS 

help [args] 

DESCRIPTION 

Help finds information to explain a message from a command or explain the use of a command. Zero or 
more arguments may be supplied. If no arguments are given, help will prompt for one. 

The arguments may be either message numbers (which normally appear in parentheses following messages) 
or command names, of one of the following types: 

type 1 Begins with non-numerics, ends in numerics. The non-numeric prefix is usually 
an abbreviation for the program or set of routines which produced the message 
(e.g., ge6, for message 6 from the get command). 

type 2 Does not contain numerics (as a command, such as get) 
type 3 Is all numeric (e.g., 212) 

The response of the program will be the explanatory information related to the argument, if there is any. 
When all else fails, try “help stuck”. 

FILES 

/usr/lib/help directory containing files of message text. 

DIAGNOSTICS 

Use help{\) for explanations. 
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NAME 

hp - handle special functions of HP 2640 and 2621-series terminals 

SYNOPSIS 

hp [ -e ] [ -m ] 

DESCRIPTION 

Hp supports special functions of the Hewlett-Packard 2640 series of terminals, with the primary purpose of 
producing accurate representations of most nrojfiY) output. Typical uses are: 

nroff -h files ... I hp 
nroff -h -s ... files I hp 

In the latter case, nrojf will stop at the beginning of each page (including the first) and wait for you to hit 
line-feed (control-j) before resuming output. 

Regardless of the hardware options on your terminal, hp tries to do sensible things with underlining and 
reverse line-feeds. If the terminal has the “display enhancements” feature, subscripts and superscripts can 
be indicated in distinct ways. If it has the “mathematical-symbol” feature, Greek and other special charac¬ 
ters can be displayed. 

The flags are as follows: 

-e It is assumed that your terminal has the “display enhancements” feature, and so maximal use is 
made of the added display modes. Overstruck characters are presented in the Underline mode. 
Superscripts are shown in Half-bright mode, and subscripts in Half-bright, Underlined mode. If 
this flag is omitted, hp assumes that your terminal lacks the “display enhancements” feature. In 
this case, all overstruck characters, subscripts, and superscripts are displayed in Inverse Video 
mode, i.e., dark-on-light, rather than the usual light-on-dark. 

-m Requests minimization of output by removal of new-lines. Any contiguous sequence of 3 or more 
new-lines is converted into a sequence of only 2 new-lines; i.e., any number of successive blank 
lines produces only a single blank output line. This allows you to retain more actual text on the 
screen. 

With regard to Greek and other special characters, hp provides the same set as does 300(1), except that 
“not” is approximated by a right arrow, and only the top half of the integral sign is shown. The display is 
adequate for examining output from neqn(l). 

DIAGNOSTICS 

“line too long” if the representation of a line exceeds 1,024 characters. 

The exit codes are 0 for normal termination, 2 for all errors. 

SEE ALSO 

300(1), col(l), greek(l), neqn(l), tbl(l), troff(l). 

BUGS 

An ‘ ‘overstriking sequence’ ’ is defined as a printing character followed by a backspace followed by another 
printing character. In such sequences, if either printing character is an underscore, the other printing char¬ 
acter is shown underlined or in Inverse Video; otherwise, only the first printing character is shown (again, 
underlined or in Inverse Video). Nothing special is done if a backspace is adjacent to an ASCII control 
character. Sequences of control characters (e.g., reverse line-feeds, backspaces) can make text “disap¬ 
pear”; in particular, tables generated by thl(l) that contain vertical lines will often be missing the lines of 
text that contain the “foot” of a vertical line, unless the input to hp is piped through co/(l). 

Although some terminals do provide numerical superscript characters, no attempt is made to display them. 
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NAME 

hyphen - find hyphenated words 

SYNOPSIS 

hyphen files 

DESCRIPTION 

Hyphen finds all the hyphenated words in files and prints them on the standard output. If no arguments are 
given, the standard input is used. Thus hyphen may be used as a filter. 

BUGS 

Hyphen can’t cope with hyphenated italic (i.e., underlined) words; it will often miss them completely, or 
mangle them. 

Hyphen occasionally gets confused, but with no ill effects other than spurious extra output. 
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NAME 

id - print user and group IDs and names 

SYNOPSIS 

id 

DESCRIPTION 

Id writes a message on the standard output giving the user and group IDs and the corresponding names of 
the invoking process. If the effective and real IDs do not match, both are printed. 

SEE ALSO 

logname(I), getuid(2), getgid(2). 
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NAME 

install - install commands 
SYNOPSIS 

install [ -c dira ] [ -f dirb ] [ -i ] [ -n dire ] [ -o ] [ -s ] file [ dirx ... ] 

DESCRIPTION 

Install is a command most commonly used in “makefiles” (see make(\)) to install a file (updated target 
file) in a specific place within a file system. Each file is installed by copying it into the appropriate direc¬ 
tory, thereby retaining the mode and owner of the original command. The program prints messages telling 
the user exactly what files it is replacing or creating and where they are going. 

If no options or directories (dirx ...) are given, install will search (using find(l)) a set of default directories 
(/bin, /usr/bin, /etc, /lib, and /usr/lib, in that order) for a file with the same name as file. When the first 
occurrence is found, install issues a message saying that it is overwriting that file with, file, and proceeds to 
do so. If the file is not found, the program states this and exits without further action. 

If one or more directories (dirx .. .) are specified after file, those directories will be searched before the 
directories specified in the default list. 

The meanings of the options are: 

-c dira Installs a new command in the directory specified in dira. Looks for file in dira 

and installs it there if it is not found. If it is found, install issues a message saying 
that the file already exists, and exits without overwriting it. May be used alone or 
with the -s option. 

-f dirb Forces file to be installed in given directory, whether or not one already exists. If 

the file being installed does not already exist, the mode and owner of the new file 
will be set to 755 and bin, respectively. If the file already exists, the mode and 
owner will be that of the already existing file. May be used alone or with the -o or 
-s options. 

-i Ignores default directory list, searching only through the given directories (dirx 

...). May be used alone or with any other options other than -c and -f. 

-n dire If file is not found in any of the searched directories, it it put in the directory 

specified in dire. The mode and owner of the new file will be set to 755 and bin, 
respectively. May be used alone or with any other options other than -c and -f. 

-o If file is found, this option saves the “found” file by copying it to OUyfile in the 

directory in which it was found. May be used alone or with any other options 
other than -c. 

-s 

SEE ALSO 

mk(8). 


Suppresses printing of messages other than error messages. May be used alone or 
with any other options. 
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NAME 

join - relational database operator 
SYNOPSIS 

join [ options ] filel file! 

DESCRIPTION 

Join forms, on the standard output, a join of the two relations specified by the lines oi filel and filel. If 
filel is the standard input is used. 

Filel and filel must be sorted in increasing ASCII collating sequence on the fields on which they are to be 
joined, normally the first in each line. 

There is one line in the output for each pair of lines in filel and filel that have identical join fields. The 
output line normally consists of the common field, then the rest of the line from filel , then the rest of the 
line ixomfilel. 

Fields are normally separated by blank, tab or new-line. In this case, multiple separators count as one, and 
leading separators are discarded. 

These options are recognized: 

-an In addition to the normal output, produce a line for each unpairable line in file n, where n is 1 or 2. 
-e 5 Replace empty output fields by string s. 

-jn m Join on the mth field of file n. If n is missing, use the mth field in each file. 

-o list Each output line comprises the fields specifed in list, each element of which has the form n.m, 
where n is a file number and m is a field number. 

-tc Use character c as a separator (tab character). Every appearance of c in a line is significant. 

SEE ALSO 

awk(l), comm(l), sort(l). 

BUGS 

With default field separation, the collating sequence is that of sort -b; with -t, the sequence is that of a 
plain sort. 

The conventions of join, sort, comm, uniq and awkfiV) are wildly incongruous. 
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NAME 

kas - assembler for the KMCl 1 microprocessor 
SYNOPSIS 

kas [ name ] [ -o name 1 ] [ -d name2 ] 

DESCRIPTION 

Kas is an assembler/debugger/loader for the KMC 11 microprocessor. The optional argument name 
specifies the input file; default is standard input. The optional argument -o indicates that the next argument 
namel will be the output of the assembler; default is a.out. The optional argument -d indicates that the 
assembler is to be used in debug mode and that the next argument name2 is the device file name of the 
microprocessor. No output file is created in debug mode. 

Error diagnostics are written on the standard error output and contain the input file name and line number 
and a brief description of the error. C preprocessor control lines to change the file name and line number 
are recognized. This allows the use of the preprocessor to expand the input before assembly. 

FILES 

a.out output object 

/dev/kmc? microprocessor device 

/lib/cpp C preprocessor 

SEE ALSO 

kun(l), kmc(4). 

Assembler for the DEC KMC 11 Microprocessor by L. A. Wehr. 
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NAME 

kill - terminate a process 
SYNOPSIS 

kill [ -signo ] processid ... 

DESCRIPTION 

Kill sends signal 15 (terminate) to the specified processes. This will normally kill processes that do not 
catch or ignore the signal. The process number of each asynchronous process started with & is reported by 
the Shell (unless more than one process is started in a pipeline, in which case the number of the last process 
in the pipeline is reported). Process numbers can also be found by using /7.s(l). 

The details of the kill are described in kill(2). For example, if process number 0 is specified, all processes 
in the process group are signaled. 

The killed process must belong to the current user unless he is the super-user. 

If a signal number preceded by - is given as first argument, that signal is sent instead of terminate (see 
signal(2)). In particular “kill -9 ...” is a sure kill. 

SEE ALSO 

ps(l), sh(l), kill(2), signal(2). 
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NAME 

kun - un-assembler for the KMCl 1/DMCl 1 microprocessor 
SYNOPSIS 

kun [ name ] [ -o namel ] 

DESCRIPTION 

Kun is a un-assembler for the KMCll/DMCll microprocessors. It produces an output listing, acceptable to 
the assembler kas(\), from the input object. 

The optional argument name specifies the input object, default is standard input. The format of the input is 
either assembler output (first word magic 0410), or formatted dump (first word magic 0440), or raw dump 
(anything else). In the first two cases, the header is ignored. 

The optional argument -o indicates that the next argument namel is to contain the output listing, default is 
standard output. 

The input object is first scanned to determine branch destinations. Labels will be inserted at these locations 
with format Lmr:, where int is the octal value of the location in words. Immediate values of instructions 
are also printed in octal. Page breaks are noted by the labels PO:,..., P3:. 

SEE ALSO 

kas(l), kmc(4). 
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NAME 

Id - link editor 
SYNOPSIS 

Id [ -sulxXrdnim ] [ -o name ] [ -t name ] [ -V num ] file ... 

DESCRIPTION 

Ld combines several object programs into one; resolves external references; and searches libraries (as cre¬ 
ated by iir(l)). In the simplest case several object files are given, and Id combines them, producing an 
object module which can be either executed or become the input for a further Id run. (In the latter case, the 
-r option must be given to preserve the relocation bits.) The output of Id is left on a.out. This file is made 
executable if no errors occurred during the load and the -r flag was not specified. 

The argument routines are concatenated in the order specified. The entry point of the output is the begin¬ 
ning of the first routine. 

If any argument is a library, it is searched exactly once at the point it is encountered in the argument list. 
Only those routines defining an unresolved external reference are loaded. If a routine from a library refer¬ 
ences another routine in the library, the referenced routine must appear after the referencing routine in the 
library. Thus the order of programs within libraries is important. 

The symbols _etext, edata and end (etext, edata and end in C) are reserved, and if referred to, are set to 
the first location above the program, the first location above initialized data, and the first location above all 
data respectively. It is erroneous to define these symbols. 

Ld understands several flag arguments which are written preceded by a -. Except for -I, they should appear 
before the file names. 

-s “Strip” the output, that is, remove the symbol table and relocation bits to save space (but impair 
the usefulness of the debugger). This information can also be removed by strip(l). This option is 
turned off if there are any undefined symbols. 

-u Take the following argument as a symbol and enter it as undefined in the symbol table. This is 
useful for loading wholly from a library, since initially the symbol table is empty and an unre¬ 
solved reference is needed to force the loading of the first routine. 

-I This option is an abbreviation for a library name. -1 alone stands for /lib/libc.a, which is the stan¬ 
dard system library for C and assembly language programs, -he stands for /lib/libx.a, where is a 
string. If that does not exist. Id tries /usr/lib/libx.a A library is searched when its name is encoun¬ 
tered, so the placement of a -I is significant. 

-X Do not preserve local (non-.globi) symbols in the output symbol table; only enter external sym¬ 
bols. This option saves some space in the output file. 

-X Save local symbols except for those whose names begin with L. This option is used by cc to dis¬ 
card internally generated labels while retaining symbols local to routines. 

-r Generate relocation bits in the output file so that it can be the subject of another Id run. This flag 
also prevents final definitions from being given to common symbols, and suppresses the 
“undefined symbol” diagnostics. 

-d Force definition of common storage even if the -r flag is present. 

-n Arrange that when the output file is executed, the text portion will be read-only and shared among 
all users executing the file. This involves moving the data areas up to the first possible 4K word 
boundary following the end of the text. On the VAX 11/780, this option is on by default; use -N to 
turn it off. 

-i When the output file is executed, the program text and data areas will live in separate address 
spaces. The only difference between this option and -n is that here the data starts at location 0. 
This option is meaningful only on the PDP-11; it does nothing on the VAX. 
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-m The names of all files and archive members used to create the output file are written to the standard 
output. 

-o The name argument after -o is used as the name of the Id output file, instead of a.out. 

-t The name argument is taken to be a symbol name, and any references to or definitions of that sym¬ 

bol are listed, along with their types. There can be up to 16 occurrences of -tname on the com¬ 
mand line. 

-V The num argument is taken as a decimal version number identifying the a.out that is produced. 
Num must be in the range 0-32767. The version stamp is stored in the a.out header; see a.out(5). 

FILES 

/lib/lib?.a libraries 

/usr/lib/lib?.a more libraries 

a.out output file 

SEE ALSO 

ar(l), as(l), cc(l), a.out(5). 
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NAME 

lex - generate programs for simple lexical tasks 
SYNOPSIS 

lex [ -rctvn ] [ file ] ... 

DESCRIPTION 

Lex generates programs to be used in simple lexical analysis of text. 

The input files (standard input default) contain strings and expressions to be searched for, and C text to be 
executed when strings are found. 

A file lex.yy.c is generated which, when loaded with the library, copies the input to the output except when 
a string specified in the file is found; then the corresponding program text is executed. The actual string 
matched is left in yytext, an external character array. Matching is done in order of the strings in the file. 
The strings may contain square brackets to indicate character classes, as in [abx-z] to indicate a, b, x, y, 
and z; and the operators *, +, and ? mean respectively any non-negative number of, any positive number 
of, and either zero or one occurrences of, the previous character or character class. The character . is the 
class of all ASCII characters except new-line. Parentheses for grouping and vertical bar for alternation are 
also supported. The notation r{d.,e} in a rule indicates between d and e instances of regular expression r. 
It has higher precedence than I, but lower than *, , and concatenation. The character'' at the beginning 

of an expression permits a successful match only immediately after a new-line, and the character $ at the 
end of an expression requires a trailing new-line. The character / in an expression indicates trailing context; 
only the part of the expression up to the slash is returned in yytext, but the remainder of the expression must 
follow in the input stream. An operator character may be used as an ordinary symbol if it is within " sym¬ 
bols or preceded by \. Thus [a-zA-Z]+ matches a string of letters. 

Three subroutines defined as macros are expected: input() to read a character; unput(c) to replace a charac¬ 
ter read; and output(c) to place an output character. They are defined in terms of the standard streams, but 
you can override them. The program generated is named yylex(), and the library contains a main() which 
calls it. The action REJECT on the right side of the rule causes this match to be rejected and the next suit¬ 
able match executed; the function yymore() accumulates additional characters into the same yytexf, and the 
function yylessf/?) pushes back the portion of the string matched beginning at p, which should be between 
yytext and yytext+yyleng. The macros input and output use files yyin and yyout to read from and write to, 
defaulted to stdin and stdout, respectively. 

Any line beginning with a blank is assumed to contain only C text and is copied; if it precedes % % it is 
copied into the external definition area of the lex.yy.c file. All rules should follow a %%, as in YACC. 
Lines preceding % % which begin with a non-blank character define the string on the left to be the remain¬ 
der of the line; it can be called out later by surrounding it with {}. Note that curly brackets do not imply 
parentheses; only string substitution is done. 

EXAMPLE 


D 

[0-9] 

%% 

if 

printfC'lF statement\n"); 

[a-z]+ 

printf("tag, value %s\n",yytext); 

0{D}-h 

printf("octal number %s\n",yytext); 

{D} + 

printf("decimal number %s\n",yytext); 

"++" 

printf("unary op\n"); 


printf("binary op\n"); 

7^” 

{ loop: 


while (inputO != 
switch (inputO) 

{ 

case 7': break; 
case unput('*'); 
default: go to loop; 
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The external names generated by lex all begin with the prefix yy or YY. 

The flags must appear before any files. The flag -r indicates RATFOR actions, -c indicates C actions and is 
the default, -t causes the lex.yy.c program to be written instead to standard output, -v provides a one-line 
summary of statistics of the machine generated, -n will not print out the - summary. Multiple files are 
treated as a single file. If no files are specified, standard input is used. 

Certain table sizes for the resulting finite state machine can be set in the definitions section: 

%p « number of positions is n (default 2000) 

%n « number of states is n (500) 

%tn number of parse tree nodes is n (1000) 

% 2 in number of transitions is n (3000) 

The use of one or more of the above automatically implies the -v option, unless the -n option is used. 

SEE ALSO 

yacc(l). 

LEX - Lexical Analyzer Generator by M. E. Lesk and E. Schmidt. 

BUGS 

The -r option is not yet fully operational. 
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NAME 

line - read one line 

SYNOPSIS 

line 

DESCRIPTION 

Line copies one line (up to a new-line) from the standard input and writes it on the standard output. It 
returns an exit code of 1 on EOF and always prints at least a new-line. It is often used within shell files to 
read from the user’s terminal. 

SEE ALSO 

sh(l), read(2). 



LINK(IM) 


LINK(IM) 


NAME 

link, unlink - exercise link and unlink system calls 

SYNOPSIS 

/etc/link filel file2 
/etc/unlink file 

DESCRIPTION 

Link and unlink perform their respective system calls on their arguments, abandoning all error checking. 
These commands may only be executed by the super-user, who (it is hoped) knows what he or she is doing. 

SEE ALSO 

rm(l), link(2), unlink(2). 
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NAME 

lint - a C program checker 
SYNOPSIS 

lint [ -abchnpuvx ] file ... 

DESCRIPTION 

Lint attempts to detect features of the C program files which are likely to be bugs, non-portable, or waste¬ 
ful. It also checks type usage more strictly than the compilers. Among the things which are currently 
detected are unreachable statements, loops not entered at the top, automatic variables declared and not used, 
and logical expressions whose value is constant. Moreover, the usage of functions is checked to find func¬ 
tions which return values in some places and not in others, functions called with varying numbers of argu¬ 
ments, and functions whose values are not used. 

It is assumed that all the files are to be loaded together; they are checked for mutual compatibility. By 
default, lint uses function definitions from the standard lint library llib-lc In; function definitions from the 
portable lint library llib-port In are used when lint is invoked with the -p option. 

Any number of lint options may be used, in any order. The following options are used to suppress certain 
kinds of complaints: 

-a Suppress complaints about assignments of long values to variables that are not long. 

-b Suppress complaints about break statements that cannot be reached. (Programs produced by lex 

or yacc will often result in a large number of such complaints.) 

-c Suppress complaints about casts that have questionable portability. 

-h Do not apply heuristic tests that attempt to intuit bugs, improve style, and reduce waste. 

-u Suppress complaints about functions and external variables used and not defined, or defined and 
not used. (This option is suitable for running lint on a subset of files of a larger program.) 

-V Suppress complaints about unused arguments in functions. 

-X Do not report variables referred to by external declarations but never used. 

The following arguments alter lint’s behavior: 

-n Do not check compatibility against either the standard or the portable lint library. 

-p Attempt to check portability to other dialects (IBM and GCOS) of C. 

The -D, -U, and -I options of cc(l) are also recognized as separate arguments. 

Certain conventional comments in the C source will change the behavior of lint: 

/^NOTREACHED*/ 

at appropriate points stops comments about unreachable code. 

/^VARARGSn^i^/ 

suppresses the usual checking for variable numbers of arguments in the following func¬ 
tion declaration. The data types of the first n arguments are checked; a missing n is taken 
to be 0. 

/*ARGSUSED=i^/ 

turns on the -v option for the next function. 

/^LINTLIBRARY^/ 

at the beginning of a file shuts off complaints about unused functions in this file. 

Lint produces its first output on a per source file basis. Complaints regarding included files are collected 
and printed after all source files have been processed. Finally, information gathered from all input files is 
collected and checked for consistency. At this point, if it is not clear whether a complaint stems from a 
given source file or from one of its included files, the source file name will be printed followed by a ques¬ 
tion mark. 
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FILES 

/usr/lib/lint[ 12] programs 

/usr/lib/llib-lc.ln declarations for standard functions (binary format; source is in /usr/lib/llib-lc) 
/usr/lib/llib-port.ln declarations for portable functions (binary format; source is in /usr/lib/llib-port) 
/usr/tmp/*lint* temporaries 

SEE ALSO 

cc(l). 

BUGS 

Exit{l) and other functions which do not return are not understood; this causes various lies. 
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NAME 

login - sign on 
DESCRIPTION 

The login command is used at the beginning of each terminal session and allows you to identify yourself to 
the system. It can no longer be invoked explicitly, but is invoked by the system when a connection is first 
established, or after the previous user has logged out by sending an “end-of-file” (control-D) to his or her 
initial shell. (See How to Get Started at the beginning of this volume for instructions on how to dial up ini¬ 
tially.) 

Login asks for your user name, and, if appropriate, your password. Echoing is turned off (where possible) 
during the typing of your password, so it will not appear on the written record of the session. 

At some installations, an option may be invoked that will require you to enter a second “external” pass¬ 
word. This will occur only for dial-up connections, and will be prompted by the message “External secu¬ 
rity:”. Both passwords are required for a successful login. 

If password aging has been invoked by the super-user on your behalf, your password may have expired. In 
this case, you will be shunted into passwdG) to change it, after which you may attempt to login again. 

If you do not complete the login successfully within a certain period of time (e.g., one minute), you are 
likely to be silently disconnected. 

After a successful login, accounting files are updated, you will be informed of the existence (if any) of mail, 
and the profiles (i.e., /etc/profile and $HOME/.profile) (if any) are executed (see profile(5)). Login initial¬ 
izes the user and group IDs and the working directory, then executes a command interpreter (usually 5/?(l)) 
according to specifications found in the /etc/passwd file. Argument 0 of the command interpreter is - fol¬ 
lowed by the last component of the interpreter’s path name. The environment (see environil)) is initialized 
to: 

}\OME=your’login-directory 

PATH=:/bin:/usr/bin 

'LOGt^P\ME—your-login-name 

FILES 

/etc/utmp 
/usr/adm/wtmp 
l\xs,xlmai\lyour-name 
/etc/motd 
/etc/passwd 
/etc/profile 
$HOME/.profile 

SEE ALSO 

mail(l), newgrp(l), sh(l), passwd(l), su(l), passwd(5), profile(5), environ(7), getty(8). 

DIAGNOSTICS 

Login incorrect 

if the user name or the password is incorrect. 

No shelly cannot open password file, no directory: 

consult a UNIX programming counselor. 

Your password has expired. Choose a new one. 
if password aging is implemented. 


accounting 

accounting 

mailbox for user your-name 
message-of-the-day 
password file 
system profile 
personal profile 
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NAME 

logname - get login name 

SYNOPSIS 

logname 

DESCRIPTION 

Logname returns the contents of the environment variable $LOGNAME, which is set when a user logs into 
the system. 

FILES 

/etc/profile 
SEE ALSO 

env(l), login(l), logname(3X), environ(7). 
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NAME 

lorder - find ordering relation for an object library 

SYNOPSIS 

lorder file... 

DESCRIPTION 

The input is one or more object or library archive files (see ar(l)). The standard output is a list of pairs of 
object file names, meaning that the first file of the pair refers to external identifiers defined in the second. 
The output may be processed by tsort{l) to find an ordering of a library suitable for one-pass access by 
ld(\). 

This brash one-liner intends to build a new library from existing .o files, 
ar cr library ^ lorder *.o I tsort^ 

FILES 

*symref, *symdef temp files 

SEE ALSO 

ar(l), ld(l), tsort(l). 

BUGS 

Object files whose name do not end with .o, even when contained in library archives, are overlooked. Their 
global symbols and references are attributed to some other file. 
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NAME 

Ipr - line printer spooler 
SYNOPSIS 

Ipr [ option ... ] [ name ... ] 

DESCRIPTION 

Lpr causes the named files to be queued for printing on a line printer. If no names appear, the standard 
input is assumed; thus lpr may be used as a filter. 

The following options may be given (each as a separate argument and in any order) before any file name 
arguments: 

-c Makes a copy of the file to be sent before returning to the user. 

-r Removes the file after sending it. 

-m When printing is complete, reports that fact by mail{l). 

-n Does not report the completion of printing by mail{\). This is the default option. 

FILES 

/etc/passwd user’s identification and accounting data. 

/usr/lib/lpd line printer daemon. 

/usr/spool/lpd/* spool area. 

SEE ALSO 

dpd(lC), dpr(lC), Ipd(lC). 
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NAME 

Is - list contents of directories 
SYNOPSIS 

Is [ -logtasdrucif ] names 
DESCRIPTION 

For each directory named, Is lists the contents of that directory; for each file named, Is repeats its name and 
any other information requested. By default, the output is sorted alphabetically. When no argument is 
given, the current directory is listed. When several arguments are given, the arguments are first sorted 
appropriately, but file arguments are processed before directories and their contents. There are several 
options: 

-I List in long format, giving mode, number of links, owner, group, size in bytes, and time of last 
modification for each file (see below). If the file is a special file, the size field will contain the 
major and minor device numbers, rather than a size. 

-o The same as -I, except that the group is not printed. 

-g The same as -I, except that the owner is not printed. 

-t Sort by time of last modification (latest first) instead of by name. 

-a List all entries; in the absence of this option, entries whose names begin with a period (.) are not 

listed. 

-s Give size in blocks (including indirect blocks) for each entry. 

-d If argument is a directory, list only its name; often used with -I to get the status of a directory. 

-r Reverse the order of sort to get reverse alphabetic or oldest first, as appropriate. 

-u Use time of last access instead of last modification for sorting (with the -t option) and/or printing 

(with the -1 option). 

-c Use time of last modification of the inode (mode, etc.) instead of last modification of the file for 
sorting (-t) and/or printing (-1). 

-i For each file, print the i-number in the first column of the report. 

-f Force each argument to be interpreted as a directory and list the name found in each slot. This 

option turns off -I, -t, -s, and -r, and turns on -a; the order is the order in which entries appear in 
the directory. 

The mode printed under the -1 option consists of 11 characters that are interpreted as follows: 

The first character is: 

d if the entry is a directory; 
b if the entry is a block special file; 
c if the entry is a character special file; 
p if the entry is a fifo (a.k.a. “named pipe”) special file; 

- if the entry is an ordinary file. 

The next 9 characters are interpreted as three sets of three bits each. The first set refers to the 
owner’s permissions; the next to permissions of others in the user-group of the file; and the last to 
all others. Within each set, the three characters indicate permission to read, to write, and to exe¬ 
cute the file as a program, respectively. For a directory, “execute” permission is interpreted to 
mean permission to search the directory for a specified file. 

The permissions are indicated as follows: 

r if the file is readable; 
w if the file is writable; 
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X if the file is executable; 

- if the indicated permission is not granted. 

The group-execute permission character is given as s if the file has set-group-ID mode; likewise, 
the user-execute permission character is given as s if the file has set-user-ID mode. The last char¬ 
acter of the mode (normally x or -) is t if the 1000 (octal) bit of the mode is on; see chmod{\.) for 
the meaning of this mode. The indications of set-ID and 1000 bit of the mode are capitalized if the 
corresponding execute permission is not set. 

When the sizes of the files in a directory are listed, a total count of blocks, including indirect blocks, is 
printed. 

FILES 

/etc/passwd to get user IDs for Is -1 and Is -o. 

/etc/group to get group IDs for Is -1 and Is -g. 

SEE ALSO 

chmod(l), find(l). 
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NAME 

m4 - macro processor 

SYNOPSIS 

m4 [ options ] [ files ] 

DESCRIPTION 

M4 is a macro processor intended as a front end for Ratfor, C, and other languages. Each of the argument 
files is processed in order; if there are no files, or if a file name is the standard input is read. The pro¬ 
cessed text is written on the standard output. 

The options and their effects are as follows: 

-e Operate interactively. Interrupts are ignored and the output is unbuffered. Using this mode 
requires a special state of mind. 

-s Enable line sync output for the C preprocessor (#line ...) 

-Bmr Change the size of the push-back and argument collection buffers from the default of 4,096. 

-Hmr Change the size of the symbol table hash array from the default of 199. The size should be prime. 

-Sint Change the size of the call stack from the default of 100 slots. Macros take three slots, and non¬ 
macro arguments take one. 

-Tint Change the size of the token buffer from the default of 512 bytes. 

To be effective, these flags must appear before any file names and before any -D or -U flags: 

-Dname [=val] 

Defines name to val or to null in va/’s absence. 

—\}name 

undefines name. 

Macro calls have the form: 

name(argl,arg2,..., argn) 

The ( must immediately follow the name of the macro. If a defined macro name is not followed by a (, it is 
deemed to have no arguments. Leading unquoted blanks, tabs, and new-lines are ignored while collecting 
arguments. Potential macro names consist of alphabetic letters, digits, and underscore _, where the first 
character is not a digit. 

Left and right single quotes are used to quote strings. The value of a quoted string is the string stripped of 
the quotes. 

When a macro name is recognized, its arguments are collected by searching for a matching right parenthe¬ 
sis. Macro evaluation proceeds normally during the collection of the arguments, and any commas or right 
parentheses which happen to turn up within the value of a nested call are as effective as those in the original 
input text. After argument collection, the value of the macro is pushed back onto the input stream and res¬ 
canned. 

M4 makes available the following built-in macros. They may be redefined, but once this is done the origi¬ 
nal meaning is lost. Their values are null unless otherwise stated. 

define the second argument is installed as the value of the macro whose name is the first argument. 

Each occurrence of $n in the replacement text, where « is a digit, is replaced by the «-th 
argument. Argument 0 is the name of the macro; missing arguments are replaced by the null 
string; $# is replaced by the number of arguments; $* is replaced by a list of all the argu¬ 
ments separated by commas; $@ is like $*, but each argument is quoted (with the current 
quotes). 

undefine removes the definition of the macro named in its argument. 
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defn 

pushdef 

popdef 

ifdef 

shift 

changequote 

changecom 

divert 

undivert 

divnum 

dnl 

ifelse 

incr 

deer 

eval 

len 

index 

substr 

translit 


returns the quoted definition of its argument(s). It is useful for renaming macros, especially 
built-ins. 

like define, but saves any previous definition. 

removes current definition of its argument(s), exposing the previous one if any. 

if the first argument is defined, the value is the second argument, otherwise the third. If 
there is no third argument, the value is null. The word unix is predefined on UNIX versions 
of m4. 

returns all but its first argument. The other arguments are quoted and pushed back with 
commas in between. The quoting nullifies the effect of the extra scan that will subsequently 
be performed. 

change quote symbols to the first and second arguments. The symbols may be up to five 
characters long. Changequote without arguments restores the original values (i.e., ^ '). 

change left and right comment markers from the default # and new-line. With no arguments, 
the comment mechanism is effectively disabled. With one argument, the left marker 
becomes the argument and the right marker becomes new-line. With two arguments, both 
markers are affected. Comment markers may be up to five characters long. 

m4 maintains 10 output streams, numbered 0-9. The final output is the concatenation of the 
streams in numerical order; initially stream 0 is the current stream. The divert macro 
changes the current output stream to its (digit-string) argument. Output diverted to a stream 
other than 0 through 9 is discarded. 

causes immediate output of text from diversions named as arguments, or all diversions if no 
argument. Text may be undiverted into another diversion. Undiverting discards the diverted 
text. 

returns the value of the current output stream. 

reads and discards characters up to and including the next new-line. 

has three or more arguments. If the first argument is the same string as the second, then the 
value is the third argument. If not, and if there are more than four arguments, the process is 
repeated with arguments 4, 5, 6 and 7. Otherwise, the value is either the fourth string, or, if 
it is not present, null. 

returns the value of its argument incremented by 1. The value of the argument is calculated 
by interpreting an initial digit-string as a decimal number. 

returns the value of its argument decremented by 1. 

evaluates its argument as an arithmetic expression, using 32-bit arithmetic. Operators 
include +, -, *, /, %, '' (exponentiation), bitwise &, I, and relational; parentheses. 
Octal and hex numbers may be specified as in C. The second argument specifies the radix 
for the result; the default is 10. The third argument may be used to specify the minimum 
number of digits in the result. 

returns the number of characters in its argument. 

returns the position in its first argument where the second argument begins (zero origin), or 
-1 if the second argument does not occur. 

returns a substring of its first argument. The second argument is a zero origin number select¬ 
ing the first character; the third argument indicates the length of the substring. A missing 
third argument is taken to be large enough to extend to the end of the first string. 

transliterates the characters in its first argument from the set given by the second argument to 
the set given by the third. No abbreviations are permitted. 
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include returns the contents of the file named in the argument. 

sinclude is identical to include, except that it says nothing if the file is inaccessible. 

syscmd executes the UNIX command given in the first argument. No value is returned. 

sysval is the return code from the last call to syscmd. 

maketemp fills in a string of XXXXX in its argument with the current process ID. 

mdexit causes immediate exit from m4. Argument 1, if given, is the exit code; the default is 0. 

m4wrap argument 1 will be pushed back at final EOF; example: m4wrap(' cleanup ()') 

errprint prints its argument on the diagnostic output file. 

dumpdef prints current names and definitions, for the named items, or for all if no arguments are 
given. 

traceon with no arguments, turns on tracing for all macros (including built-ins). Otherwise, turns on 

tracing for named macros. 

traceoff turns off trace globally and for any macros specified. Macros specifically traced by traceon 
can be untraced only by specific calls to traceoff. 

SEE ALSO 

The M4 Macro Processor by B. W. Kernighan and D. M. Ritchie. 
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NAME 

mail, rmail - send mail to users or read mail 


SYNOPSIS 

mail [ -rpq ] [ -f file ] 
mail persons 
rmail persons 


DESCRIPTION 

Mail without arguments prints a user’s mail, message-by-message, in last-in, first-out order. For each mes¬ 
sage, the user is prompted with a ?, and a line is read from the standard input to determine the disposition of 
the message: 


<new-line> 

+ 

d 

P 

s [files ] 
w [files ] 
m [persons ] 

q 

EOT (control-d) 

X 

Icommand 

* 


Go on to next message. 

Same as <new-line>. 

Delete message and go on to next message. 

Print message again. 

Go back to previous message. 

Save message in the named files (mbox is default). 

Save message, without its header, in the nam^d files (mbox is default). 
Mail the message to the named persons (yourself is default). 

Put undeleted mail back in the mailfile and stop. 

Same as q. 

Put all mail back in the mailfile unchanged and stop. 

Escape to the shell to do command. 

Print a command summary. 


The optional arguments alter the printing of the mail: 

-r causes messages to be printed in first-in, first-out order. 

-p causes all mail to be printed without prompting for disposition. 

-q causes mail to terminate after interrupts. Normally an interrupt only causes the termination of the 
message being printed. 

-ifile causes mail to use file (e.g., mbox) instead of the default mailfile. 

When persons are named, mail takes the standard input up to an end-of-file (or up to a line consisting of 
just a .) and adds it to each person's mailfile. The message is preceded by the sender’s name and a post¬ 
mark. Lines that look like postmarks in the message, (i.e., “From ...’’) are preceded with a >. A person 
is usually a user name recognized by loginifi). If a person being sent mail is not recognized, or if mail is 
interrupted during input, the dead letter will be saved to allow editing and resending. 

To denote a recipient on a remote system, prefix person by the system name and exclamation mark (see 
uucp{\C)). Everything after the first exclamation mark in persons is interpreted by the remote system. In 
particular, if persons contains additional exclamation marks, it can denote a sequence of machines through 
which the message is to be sent on the way to its ultimate destination. For example, specifying alblcde as a 
recipient’s name causes the message to be sent to user bicde on system a. System a will interpret that des¬ 
tination as a request to send the message to user cde on system b. This might be useful, for instance, if the 
sending system can access system a but not system b, and system a has access to system b. 

The mailfile may be manipulated in two ways to alter the function of mail. The other permissions of the 
file may be read-write, read-only, or neither read nor write to allow different levels of privacy. If changed 
to other than the default, the file will be preserved even when empty to perpetuate the desired permissions. 
The file may also contain the first line: 

Forward to person 

which will cause all mail sent to the owner of the mailfile to be forwarded to person. This is especially 
useful to forward all of a person’s mail to one machine in a multiple machine environment. 
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Rmail only permits the sending of mail; uucp{\C) uses rmail as a security precaution. 
When a user logs in he is informed of the presence of mail, if any. 


FILES 

/etc/passwd 

/usr/mail/* 

$HOME/mbox 

$MAIL 

/tmp/ma* 

/usr/mail/*.lock 

deaddetter 


to identify sender and locate persons 

incoming mail for user *; mailfile 

saved mail 

mailfile 

temporary file 

lock for mail directory 

unmailable text 


SEE ALSO 

login(l), uucp(lC), write(l). 

BUGS 

Race conditions sometimes result in a failure to remove a lock file. 

After an interrupt, the next message may not be printed; printing may be forced by typing a p. 
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NAME 

make - maintain, update, and regenerate groups of programs 
SYNOPSIS 

make [-f makefile] [-p] [-i] [-k] [-s] [-r] [-n] [-b] [-e] [-m] [-t] [-q] [-d] [ names ] 

DESCRIPTION 

The following is a brief description of all options and some special names: 

-f makefile Description file name. Makefile is assumed to be the name of a description file. A file name of 
- denotes the standard input. The contents of makefile override the built-in rules if they are 
present. 

-p Print out the complete set of macro definitions and target descriptions. 

-i Ignore error codes returned by invoked commands. This mode is entered if the fake target 

name .IGNORE appears in the description file. 

-k Abandon work on the current entry, but continue on other branches that do not depend on that 

entry. 

-s Silent mode. Do not print command lines before executing. This mode is also entered if the 

fake target name .SILENT appears in the description file. 

-r Do not use the built-in rules. 

-n No execute mode. Print commands, but do not execute them. Even lines beginning with an @ 

are printed. 

-b Compatibility mode for old makefiles. 

-e Environment variables override assignments within makefiles. 

-m Print a memory map showing text, data, and stack. This option is a no-operation on systems 

without the getu system call. 

-t Touch the target files (causing them to be up-to-date) rather than issue the usual commands. 

-d Debug mode. Print out detailed information on files and times examined. 

-q Question. The make command returns a zero or non-zero status code depending on whether 

the target file is or is not up-to-date. 

.DEFAULT If a file must be made but there are no explicit commands or relevant built-in rules, the com¬ 
mands associated with the name .DEFAULT are used if it exists. 

.PRECIOUS 

Dependents of this target will not be removed when quit or interrupt are hit. 

.SILENT Same effect as the -s option. 

.IGNORE Same effect as the -i option. 

Make executes commands in makefile to update one or more target names. Name is typically a program. If 
no -f option is present, makefile, Makefile, s makefile, and s.Makefile are tried in order. If makefile is 
the standard input is taken. More than one -f makefile argument pair may appear. 

Make updates a target only if it depends on files that are newer than the target. All prerequisite files of a 
target are added recursively to the list of targets. Missing files are deemed to be out of date. 

Makefile contains a sequence of entries that specify dependencies. The first line of an entry is a blank- 
separated, non-null list of targets, then a :, then a (possibly null) list of prerequisite files or dependencies. 
Text following a ; and all following lines that begin with a tab are shell commands to be executed to update 
the target. The first line that does not begin with a tab or # begins a new dependency or macro definition. 
Shell commands may be continued across lines with the <backslash><new-line> sequence. Sharp (#) and 
new-line surround comments. 
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The following makefile says that pgm depends on two files a.o and b.o, and that they in turn depend on 
their corresponding source files (a.c and b.c) and a common file incl.h: 

pgm: a.o b.o 

cc a.o b.o -o pgm 

a. o: incl.h a.c 

cc -c a.c 

b. o: incl.h b.c 

cc -c b.c 

Command lines are executed one at a time, each by its own shell. A line is printed when it is executed 
unless the -s option is present, or the entry .SILENT: is in makefile, or unless the first character of the com¬ 
mand is The -n option specifies printing without execution; however, if the command line has the 
string $(MAKE) in it, the line is always executed (see discussion of the MAKEFLAGS macro under 
Environment). The -t (touch) option updates the modified date of a file without executing any commands. 

Commands returning non-zero status normally terminate make. If the -i option is present, or the entry 
.IGNORE: appears in makefile, or if the line specifying the command begins with <tab><hyphen>, the error 
is ignored. If the -k option is present, work is abandoned on the current entry, but continues on other 
branches that do not depend on that entry. 

The -b option allows old makefiles (those written for the old version of make) to run without errors. The 
difference between the old version of make and this version is that this version requires all dependency 
lines to have a (possibly null) command associated with them. The previous version of make assumed if no 
command was specified explicitly that the command was null. 

Interrupt and quit cause the target to be deleted unless the target depends on the special name .PRECIOUS. 
Environment 

The environment is read by make. All variables are assumed to be macro definitions and processed as such. 
The environment variables are processed before any makefile and after the internal rules; thus, macro 
assignments in a makefile override environment variables. The -e option causes the environment to over¬ 
ride the macro assignments in a makefile. 

The MAKEFLAGS environment variable is processed by make as containing any legal input option (except 
-f, -p, and -d) defined for the command line. Further, upon invocation, make “invents” the variable if it 
is not in the environment, puts the current options into it, and passes it on to invocations of commands. 
Thus, MAKEFLAGS always contains the current input options. This proves very useful for “super¬ 
makes”. In fact, as noted above, when the -n option is used, the command $(MAKE) is executed anyway; 
hence, one can perform a make -n recursively on a whole software system to see what would have been 
executed. This is because the -n is put in MAKEFLAGS and passed to further invocations of $(MAKE). 
This is one way of debugging all of the makefiles for a software project without actually doing anything. 

Macros 

Entries of the form string! = string! are macro definitions. Subsequent appearances of 
%{stringl[.substl =[suhst2]'\) are replaced by string!. The parentheses are optional if a single character 
macro name is used and there is no substitute sequence. The optional :substl=subst! is a substitute 
sequence. If it is specified, all non-overlapping occurrences of substl in the named macro are replaced by 
subst!. Strings (for the purposes of this type of substitution) are delimited by blanks, tabs, new-line charac¬ 
ters, and beginnings of lines. An example of the use of the substitute sequence is shown under Libraries. 

Internal Macros 

There are five internally maintained macros which are useful for writing rules for building targets. 

$* The macro $* stands for the file name part of the current dependent with the suffix deleted. It is eval¬ 
uated only for inference rules. 

$@ The $@ macro stands for the full target name of the current target. It is evaluated only for explicitly 
named dependencies. 
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$< The $< macro is only evaluated for inference rules or the .DEFAULT rule. It is the module which is 
out of date with respect to the target (i.e., the “manufactured” dependent file name). Thus, in the 
.c.o rule, the $< macro would evaluate to the .c file. An example for making optimized .o files from 
•c files is: 

.c.o: 

cc -c -O $*.c 
or: 

.c.o: 

cc -c -O $< 

$? The $? macro is evaluated when explicit rules from the makefile are evaluated. It is the list of prereq¬ 
uisites that are out of date with respect to the target; essentially, those modules which must be rebuilt. 

$% The $% macro is only evaluated when the target is an archive library member of the form lib(file.o). 
In this case, $@ evaluates to lib and $% evaluates to the library member, file.o. 

Four of the five macros can have alternative forms. When an upper case D or F is appended to any of the 
four macros the meaning is changed to “directory part” for D and “file part” for F. Thus, $(@D) refers to 
the directory part of the string $@. If there is no directory part. The only macro excluded from this alterna¬ 
tive form is $?. The reasons for this are debatable. 

Suffixes 

Certain names (for instance, those ending with .o) have inferable prerequisites such as .c, .s, etc. If no 
update commands for such a file appear in makefile, and if an inferable prerequisite exists, that prerequisite 
is compiled to make the target. In this case, make has inference rules which allow building files from other 
files by examining the suffixes and determining an appropriate inference rule to use. The current default 
inference rules are: 

.c .c' .sh .sh' .c.o .c'.o .c'.c .s.o .s'.o .y.o .y'.o .l.o .I'.o 
.y.c .y'.c .l.c .c.a .c'.a .s'.a .h'.h 

The internal rules for make are contained in the source file rules.c for the make program. These rules can 
be locally modified. To print out the rules compiled into the make on any machine in a form suitable for 
recompilation, the following command is used: 

make -fp - 2>/dev/null </dev/null 

The only peculiarity in this output is the (null) string which printf(3S) prints when handed a null string. 

A tilde in the above rules refers to an SCCS file (see sccsfile(5)). Thus, the rule .c'.o would transform an 
sees C source file into an object file (.o). Because the s. of the SeeS files is a prefix it is incompatible with 
make's, suffix point-of-view. Hence, the tilde is a way of changing any file reference into an SeeS file ref¬ 
erence. 

A rule with only one suffix (i.e. .c:) is the definition of how to build x from x.c. In effect, the other suffix is 
null. This is useful for building targets from only one source file (e.g., shell procedures, simple C pro¬ 
grams). 

Additional suffixes are given as the dependency list for .SUFFIXES. Order is significant; the first possible 
name for which both a file and a rule exist is inferred as a prerequisite. 

The default list is: 

.SUFFIXES: .o .c .y .1 .s 

Here again, the above command for printing the internal rules will display the list of suffixes implemented 
on the current machine. Multiple suffix lists accumulate; .SUFFIXES: with no dependencies clears the list 
of suffixes. 

Inference Rules 

The first example can be done more briefly: 
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pgm: a.o b.o 

cc a.o b.o -o pgm 
a.o b.o: incl h 

This is because make has a set of internal rules for building files. The user may add rules to this list by sim¬ 
ply putting them in the makefile. 

Certain macros are used by the default inference rules to permit the inclusion of optional matter in any 
resulting commands. For example, CFLAGS, LFLAGS, and YFLAGS are used for compiler options to 
cc(l), lex{\), and yacc{\) respectively. Again, the previous method for examining the current rules is rec¬ 
ommended. 

The inference of prerequisites can be controlled. The rule to create a file with suffix .o from a file with 
suffix .c is specified as an entry with .c.o: as the target and no dependents. Shell commands associated with 
the target define the rule for making a .o file from a .c file. Any target that has no slashes in it and starts 
with a dot is identified as a rule and not a true target. 

Libraries 

If a target or dependency name contains parenthesis, it is assumed to be an archive library, the string within 
parenthesis referring to a member within the library. Thus lib(flle.o) and $(LIB)(file.o) both refer to an 
archive library which contains flle.o. (This assumes the LIB macro has been previously defined.) The 
expression $(LIB)(fllel.o file2.o) is not legal. Rules pertaining to archive libraries have the form .AA.a 
where the XX is the suffix from which the archive member is to be made. An unfortunate byproduct of the 
current implementation requires the XX to be different from the suffix of the archive member. Thus, one 
cannot have lib(file.o) depend upon file.o explicitly. The most common use of the archive interface fol¬ 
lows. Here, we assume the source files are all C type source: 

lib: lib(filel.o) lib(file2.o) lib(file3.o) 

©echo lib is now up to date 

.c.a: 

$(CC) -c $(CFLAGS) $< 
ar rv $@ $^.o 
rm -f $*.o 

In fact, the .c.a rule listed above is built into make and is unnecessary in this example. A more interesting, 
but more limited example of an archive library maintenance construction follows: 

lib: lib(filel.o) lib(file2.o) lib(file3.o) 

$(CC) -c $(CFLAGS) $(?:.o=.c) 
ar rv lib $? 

rm $? ©echo lib is now up to date 

.c.a:; 

Here the substitution mode of the macro expansions is used. The $? list is defined to be the set of object 
file names (inside lib) whose C source files are out of date. The substitution mode translates the .o to .c. 
(Unfortunately, one cannot as yet transform to .c"; however, this may become possible in the future.) Note 
also, the disabling of the .c.a: rule, which would have created each object file, one by one. This particular 
construct speeds up archive library maintenance considerably. This type of construct becomes very cum¬ 
bersome if the archive library contains a mix of assembly programs and C programs. 

FILES 

[Mmjakefile 

s.[Mm]akefile 

SEE ALSO 

sh(l), mk(8). 

Make-A Program for Maintaining Computer Programs by S. I. Feldman. 

An Augmented Version of Make by E. G. Bradford. 
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BUGS 

Some commands return non-zero status inappropriately; use -i to overcome the difficulty. Commands that 
are directly executed by the shell, notably cd{\), are ineffectual across new-lines in make. The syntax 
(lib(filel.o file2.o flle3.o) is illegal. You cannot build lib(file.o) from file.o. The macro $(a:.o=.c‘’) doesn’t 
work. 
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NAME 

man - print entries in this manual 
SYNOPSIS 

man [ options ] [ section ] titles 
DESCRIPTION 

Man locates and prints the entry of this manual named title in the specified section. (For historical reasons, 
the word “page” is often used as a synonym for “entry” in this context.) The title is entered in lower 
case. The section number may not have a letter suffix. If no section is specified, the whole manual is 
searched for title and all occurrences of it are printed. Options and their meanings are: 

-t Typeset the entry in the default format (8.5"xl I"). 

-s Typeset the entry in the small format (6"x9")- 

-T4014 Display the typeset output on a Tektronix 4014 terminal using fc(l). 

-Ttek Same as -T4014. 

-Tst Print the typeset output on the MHCC STARE facility (see gcat(lC)). 

-Tvp Print the typeset output on a Versatec printer using vpr(l); this option is not available at all 

UNIX sites. 

-Tterm Format the entry using nroJf(\) and print it on the standard output (usually, the terminal); 

term is the terminal type (see term(l) and the explanation below); for a list of recognized val¬ 
ues of term, type help term2. The default value of term is 450. 

-w Print on the standard output only the path names of the entries, relative to /usr/man, or to the 

current directory for -d option. 

-d Search the current directory rather than /usr/man; requires the full file name (e.g., cu.lc, 

rather than just cu). 

-12 Indicates that the manual entry is to be produced in 12-pitch. May be used when $TERM (see 

below) is set to one of 300, 300s, 450, and 1620. (The pitch switch on the DASI 300 and 300s 
terminals must be manually set to 12 if this option is used.) 

-c Causes man to invoke col(\); note that co/(l) is invoked automatically by man unless term is 

one of 300, 300s, 450, 37, 4000A, 382, 4014, tek, 1620, and X. 

-y Causes man to use the non-compacted version of the macros. 

The above options are mutually exclusive, except that the -s option may be used in conjunction with the 
first four -T options above. Any other options are passed to trojf{\), nrojf{\), or the man{l) macro pack¬ 
age. 

When using nrojf{l), man examines the environment variable $TERM (see environil)) and attempts to 
select options to nrojf{\), as well as filters, that adapt the output to the terminal being used. The -Tterm 
option overrides the value of $TERM; in particular, one should use -Tip when sending the output of man to 
a line printer. 

Section may be changed before each title. 

As an example: 

man man 

would reproduce on the terminal this entry, as well as any other entries named man that may exist in other 
sections of the manual, e.g., manil). 

If the first line of the input for an entry consists solely of the string: 

'V’ X 

where x is any combination of the three characters c, e, and t, and where there is exactly one blank between 
the double quote (") and x, then man will preprocess its input through the appropriate combination of 
cw(l), eqn{\) or neqn{l), and tbl{l), respectively. 

FILES 


/usr/man/man[ 1 -8]A 
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/usr/man/local/man[l-8]/* 

SEE ALSO 

cw(l), eqn(l), gcat(lC), tbl(l), tc(l), troff(l), environ(7), man(7), term(7). 

BUGS 

All entries are supposed to be reproducible either on a typesetter or on a terminal. However, on a terminal 
some information is necessarily lost. 
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NAME 

mesg - permit or deny messages 

SYNOPSIS 

mesg [ n ] [ y ] 

DESCRIPTION 

Mesg with argument n forbids messages via wnte{\) by revoking non-user write permission on the user’s 
terminal. Mesg with argument y reinstates permission. All by itself, mesg reports the current state without 
changing it. 

FILES 

/dev/tty* 

SEE ALSO 

write(l). 

DIAGNOSTICS 

Exit status is 0 if messages are receivable, 1 if not, 2 on error. 
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NAME 

mkdir - make a directory 

SYNOPSIS 

mkdir dirname... 

DESCRIPTION 

Mkdir creates specified directories in mode 111. Standard entries, for the directory itself, and for its 
parent, are made automatically. 

Mkdir requires write permission in the parent directory. 

SEE ALSO 

rm(l). 

DIAGNOSTICS 

Mkdir returns exit code 0 if all directories were successfully made; otherwise, it prints a diagnostic and 
returns non-zero. 
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NAME 

mkfs - construct a file system 
SYNOPSIS 

/etc/mkfs special blocks[:inodes] [gap blocks] 

/etc/mkfs special proto [gap blocks] 

DESCRIPTION 

Mkfs constructs a file system by writing on the special file according to the directions found in the remain¬ 
der of the command line. If the second argument is given as a string of digits, mkfs builds a file system 
with a single empty directory on it. The size of the file system is the value of blocks interpreted as a deci¬ 
mal number. The boot program is left uninitialized. If the optional number of inodes is not given, the 
default is the number of blocks divided by 4. 

If the second argument is a file name that can be opened, mkfs assumes it to be a prototype file proto, and 
will take its directions from that file. The prototype file contains tokens separated by spaces or new-lines. 
The first token is the name of a file to be copied onto block zero as the bootstrap program (see unixboot{^)). 
The second token is a number specifying the size of the created file system. Typically it will be the number 
of blocks on the device, perhaps diminished by space for swapping. The next token is the i-list size in 
blocks (remember there are eight i-nodes per block). The next set of tokens comprise the specification for 
the root file. File specifications consist of tokens giving the mode, the user ID, the group ID, and the initial 
contents of the file. The syntax of the contents field depends on the mode. 

The mode token for a file is a 6 character string. The first character specifies the type of the file. (The char¬ 
acters -bed specify regular, block special, character special and directory files respectively.) The second 
character of the type is either u or - to specify set-user-id mode or not. The third is g or - for the set- 
group-id mode. The rest of the mode is a three digit octal number giving the owner, group, and other read, 
write, execute permissions (see chmodif)). 

Two decimal number tokens come after the mode; they specify the user and group ID’s of the owner of the 
file. 

If the file is a regular file, the next token is a path name whence the contents and size are copied. If the file 
is a block or character special file, two decimal number tokens follow which give the major and minor 
device numbers. If the file is a directory, mkfs makes the entries . and .. and then reads a list of names and 
(recursively) file specifications for the entries in the directory. The scan is terminated with the token $. 

A sample prototype specification follows: 

tsimdJdiskboot 
4872 no 
d_777 3 1 


fi¬ 

777 3 1 


sh 

-755 3 ] 

1 /bin/sh 

ken 

d—755 6 ] 
$ 

1 

bO 

b—644 3 ] 

100 

cO 

c_644 3 1 

00 


$ 

$ 

In both command syntaxes, the rotational gap and the number of blocks can be specified. For RP04 type 
drives, these numbers should be 7 and 418. 

SEE ALSO 

dir(5), fs(5), unixboot(8). 

BUGS 

If a prototype is used, it is not possible to initialize a file larger than 64K bytes, nor is there a way to specify 
links. 



MKNOD(IM) 


MKNOD(IM) 


NAME 

mknod - build special file 
SYNOPSIS 

/etc/mknod name [ c ] [ b ] major minor 
/etc/mknod name p 

DESCRIPTION 

Mknod makes a directory entry and corresponding i-node for a special file. The first argument is the name 
of the entry. In the first case, the second is b if the special file is block-type (disks, tape) or c if it is 
character-type (other devices). The last two arguments are numbers specifying the major device type and 
the minor device (e.g. unit, drive, or line number), which may be either decimal or octal. 

The assignment of major device numbers is specific to each system. They have to be dug out of the system 
source file conf.c. 

Mknod can also be used to create fifo’s (a.k.a named pipes) (second case in SYNOPSIS above). 

SEE ALSO 

mknod(2). 
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NAME 

mm - print out documents formatted with the MM macros 
SYNOPSIS 

mm [ options ] [ files ] 

DESCRIPTION 

Mm can be used to type out documents using nroff{\) and the MM text-formatting macro package. It has 
options to specify preprocessing by tbl{\) and/or neqn{l) and postprocessing by various terminal-oriented 
output filters. The proper pipelines and the required arguments and flags for nrojf{l) and MM are gener¬ 
ated, depending on the options selected. 

Options for mm are given below. Any other arguments or flags (e.g., -rC3) are passed to nroff(\) or to 
MM, as appropriate. Such options can occur in any order, but they must appear before the files arguments. 
If no arguments are given, mm prints a list of its options. 

-Tterm Specifies the type of output terminal; for a list of recognized values for term, type help term2. 

If this option is not used, mm will use the value of the shell variable $TERM from the environ¬ 
ment (see profile{5) and environil)) as the value of term, if $TERM is set; otherwise, mm will 
use 450 as the value of term. If several terminal types are specified, the last one takes prece¬ 
dence. 

-12 Indicates that the document is to be produced in 12-pitch. May be used when $TERM is set to 
one of 300, 300s, 450, and 1620. (The pitch switch on the DASI 300 and 300s terminals must be 
manually set to 12 if this option is used.) 

-c Causes mm to invoke co/(l); note that col{l) is invoked automatically by mm unless term is one 

of 300, 300s, 450, 37, 4000A, 382, 4014, tek, 1620, and X. 

-e Causes mm to invoke neqn{l). 

-t Causes mm to invoke tbl(l). 

-E Invokes the -e option of nroff(l). 

-y Causes mm to use the non-compacted version of the macros (see mm(7)). 

As an example (assuming that the shell variable $TERM is set in the environment to 450), the two com¬ 
mand lines below are equivalent: 

mm -t -rC3 -12 ghh* 

tbl ghh* I nroff -cm -T450-12 -h -rC3 

Mm reads the standard input when - is specified instead of any file names. (Mentioning other files together 
with - leads to disaster.) This option allows mm to be used as a filter, e.g.: 

cat dws I mm - 

HINTS 

1. Mm invokes nroff(\) with the -h flag. With this flag, nroff(\) assumes that the terminal has tabs 
set every 8 character positions. 

2. Use the -olist option of nroff(\) to specify ranges of pages to be output. Note, however, that mm, 
if invoked with one or more of the -e, -t, and - options, together with the -olist option of nrojf{\) 
may cause a harmless “broken pipe” diagnostic if the last page of the document is not specified in 
list. 

3. If you use the -s option of nroff(l) (to stop between pages of output), use line-feed (rather than 
return or new-line) to restart the output. The -s option of nroffO) does not work with the -c 
option of mm, or if mm automatically invokes col(l) (see -c option above). 

4. If you lie to mm about the kind of terminal its output will be printed on, you’ll get (often subtle) 
garbage; however, if you are redirecting output into a file, use the -T37 option, and then use the 
appropriate terminal filter when you actually print that file. 
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SEE ALSO 

col(l), env(l), eqn(l), greek(l), mmt(l), nroff(l), tbl(l), profile(5), mm(7), term(7). 
MM-Memorandum Macros by D. W. Smith and J. R. Mashey. 

Typing Documents with MM by D. W. Smith and E. M. Piskorik. 

DIAGNOSTICS 

‘ ‘mm: no input file’ ’ if none of the arguments is a readable file and mm is not used as a filter. 
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NAME 

mmchek - check usage of mm macros and eqn delimiters 

SYNOPSIS 

mmchek [files] 

DESCRIPTION 

Mmchek is a program for checking the contents of the named files for errors in the use of Memorandum 
Macros (see mm(l)) and some eqn{\) constructions. Appropriate messages are produced. The program 
skips all directories, and if no file name is given, standard input is read. 

SEE ALSO 

eqn(l), mm(l), mmt(l). 

MM-Memorandum Macros by D. W. Smith and J. R. Mashey. 

DIAGNOSTICS 

Unreadable files cause the message “Cannot opQn file-name". The remaining output of the program is 
diagnostic of the source file. 

BUGS 

This is an experimental version of mmchek. Mmchek may be fully supported in the future. 
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NAME 

mmt, mvt - typeset documents, view graphs, and slides 
SYNOPSIS 

mmt [ options ] [ files ] 
mvt [ options ] [ files ] 

DESCRIPTION 

These two commands are very similar to except that they both typeset their input via trojf{\), as 

opposed to formatting it via nrojf{iy, mmt uses the MM macro package, while mvt uses the Macro Package 
for View Graphs and Slides. These two commands have options to specify preprocessing by thl{\) and/or 
eqn{\). The proper pipelines and the required arguments and flags for troff{\.) and for the macro packages 
are generated, depending on the options selected. 

Options are given below. Any other arguments or flags (e.g., -rC3) are passed to trojf{\) or to the macro 
package, as appropriate. Such options can occur in any order, but they must appear before the files argu¬ 
ments. If no arguments are given, these commands print a list of their options. 

-e Causes these commands to invoke eqn{\). 

-t Causes these commands to invoke tbl{l). 

-Tst Directs the output to the MH STARE facility. 

-Tvp Directs the output to a Versatec printer via the vpr(l) spooler; this option is not available at all 
UNIX sites. 

-T4014 Directs the output to a Tektronix 4014 terminal via the tc{\) filter. 

-Ttek Same as -T4014. 

-a Invokes the -a option of trojf{l). 

-y Causes mmt to use the non-compacted version of the macros (see mmil)). No effect for mvt. 

These commands read the standard input when - is specified instead of any file names. 

Mvt is just a link to mmt. 

HINT 

Use the -olist option of troff{\) to specify ranges of pages to be output. Note, however, that these com¬ 
mands, if invoked with one or more of the -e, -t, and - options, together with the -olist option of trojf{\) 
may cause a harmless “broken pipe” diagnostic if the last page of the document is not specified in list. 

SEE ALSO 

env(l), eqn(l), mm(l), tbl(l), tc(l), troff(l), profile(5), environ(7), mm(7), mv(7). 

MM-Memorandum Macros by D. W. Smith and J. R. Mashey. 

Typing Documents with MM by D. W. Smith and E. M. Piskorik. 

A Macro Package for View Graphs and Slides by T. A. Dolotta and D. W. Smith (in preparation). 
DIAGNOSTICS 

‘ ‘m[mv]t: no input file’ ’ if none of the arguments is a readable file and the command is not used as a filter. 
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NAME 

mount, umount - mount and dismount file system 
SYNOPSIS 

/etc/mount [ special directory [ -r ] ] 

/etc/umount special 
DESCRIPTION 

Mount announces to the system that a removable file system is present on the device special. The 
directory must exist already; it becomes the name of the root of the newly mounted file system. 

These commands maintain a table of mounted devices. If invoked with no arguments, mount prints the 
table. 

The optional last argument indicates that the file is to be mounted read-only. Physically write-protected and 
magnetic tape file systems must be mounted in this way or errors will occur when access times are updated, 
whether or not any explicit write is attempted. 

Umount announces to the system that the removable file system previously mounted on device special is to 
be removed. 

FILES 

/etc/mnttab mount table 

SEE ALSO 

mount(2), mnttab(5). 

DIAGNOSTICS 

Mount issues a warning if the file system to be mounted is currently mounted under another name. 

Umount complains if the special file is not mounted or if it is busy. The file system is busy if it contains an 
open file or some user’s working directory. 

BUGS 

Some degree of validation is done on the file system, however it is generally unwise to mount garbage file 
systems. 
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NAME 

mvdir - move a directory 
SYNOPSIS 

/etc/mvdir dimame name 
DESCRIPTION 

Mvdir renames directories within a file system. Dirname must be a directory; name must not exist. Nei¬ 
ther name may be a sub-set of the other (/x/y cannot be moved to /x/y/z, nor vice versa). 

Only super-user can use mvdir. 

SEE ALSO 

mkdir(l). 
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NAME 

ncheck - generate names from i-numbers 
SYNOPSIS 

ncheck [ -i numbers ] [ -a ] [ -s ] [ file-system ] 

DESCRIPTION 

Ncheck with no argument generates a path name vs. i-number list of all files on a set of default file systems. 
Names of directory files are followed by /.. The -i option reduces the report to only those files whose i- 
numbers follow. The -a option allows printing of the names . and which are ordinarily suppressed, sup¬ 
pressed. The -s option reduces the report to special files and files with set-user-ID mode; it is intended to 
discover concealed violations of security policy. 

A file system may be specified. 

The report is in no useful order, and probably should be sorted. 

SEE ALSO 

fsck(lM), sort(l). 

DIAGNOSTICS 

When the file system structure is improper, ?? denotes the “parent” of a parentless file and a path name 
beginning with ... denotes a loop. 



NEWGRP(l) 


NEWGRP(l) 


NAME 

newgrp - log in to a new group 

SYNOPSIS 

newgrp [ group ] 

DESCRIPTION 

Newgrp changes the group identification of its caller, analogously to login{\). The same person remains 
logged in, and the current directory is unchanged, but calculations of access permissions to files are per¬ 
formed with respect to the new group ID. 

Newgrp without an argument changes the group identification to the group in the password file; in effect it 
changes the group identification back to the caller’s original group. 

A password is demanded if the group has a password and the user himself does not, or if the group has a 
password and the user is not listed in /etc/group as being a member of that group. 

When most users log in, they are members of the group named other. 

FILES 

/etc/group 

/etc/passwd 

SEE ALSO 

login(l), group(5). 

BUGS 

There is no convenient way to enter a password into /etc/group. 

Use of group passwords is not encouraged, because, by their very nature, they encourage poor security 
practices. Group passwords may disappear in the future. 
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NAME 

news - print news items 
SYNOPSIS 

news [ -a ] [ -n ] [ -s ] [ items ] 

DESCRIPTION 

News is used to keep the user informed of current events. By convention, these events are described by 
files in the directory /usr/news. 

When invoked without arguments, news prints the contents of all current files in /usr/news, most recent 
first, with each preceded by an appropriate header. News stores the “currency” time as the modification 
date of a file named news time in the user’s home directory (the identity of this directory is determined by 
the environment variable $HOME); only files more recent than this currency time are considered “current.” 

The -a option causes news to print all items, regardless of currency. In this case, the stored time is not 
changed. 

The -n option causes news to report the names of the current items without printing their contents, and 
without changing the stored time. 

The -s option causes news to report how many current items exist, without printing their names or contents, 
and without changing the stored time. It is useful to include such an invocation of news in one’s .profile 
file, or in the system’s /etc/profile. 

All other arguments are assumed to be specific news items that are to be printed. 

If a delete is typed during the printing of a news item, printing stops and the next item is started. Another 
delete within one second of the first causes the program to terminate. 

FILES 

/etc/profile 

/usr/news/* 

$HOME/ news_time 

SEE ALSO 

profile(5), environ(7). 
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NAME 

nice - run a command at low priority 
SYNOPSIS 

nice [ -increment ] command [ arguments ] 

DESCRIPTION 

Nice executes command with a lower CPU scheduling priority. If the increment argument (in the range 1- 
19) is given, it is used; if not, an increment of 10 is assumed. 

The super-user may run commands with priority higher than normal by using a negative increment, e.g., 
— 10 . 

SEE ALSO 

nohup(l), nice(2). 

DIAGNOSTICS 

Nice returns the exit status of the subject command. 

BUGS 

An increment larger than 19 is equivalent to 19. 
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NAME 

nl - line numbering filter 
SYNOPSIS 

nl [-htype] [-btype] [-ftype] [-vstart#] [-iincr] [-p] [-Inum] [-ssep] [-wwidth] [-nformat] file 
DESCRIPTION 

Nl reads lines from the named file or the standard input if no file is named and reproduces the lines on the 
standard output. Lines are numbered on the left in accordance with the command options in effect. 

Nl views the text it reads in terms of logical pages. Line numbering is reset at the start of each logical page. 
A logical page consists of a header, a body, and a footer section. Empty sections are valid. Different line 
numbering options are independently available for header, body, and footer (e.g. no numbering of header 
and footer lines while numbering blank lines only in the body). 

The start of logical page sections are signaled by input lines containing nothing but the following 
character(s): 


Line contents 

Start of 

\:\:\: 

header 

\:\: 

body 

\: 

footer 


Unless signaled otherwise, nl assumes the text being read is in a single logical page body. 

Command options may appear in any order and may be intermingled with an optional file name. Only one 
file may be named. The options are: 

Specifies which logical page body lines are to be numbered. Recognized types and their mean¬ 
ing are: a, number all lines; t, number lines with printable text only; n, no line numbering; 
pstring, number only lines that contain the regular expression specified in string. Default type 
for logical page body is t (text lines numbered). 

Same as -htype except for header. Default type for logical page header is n (no lines num¬ 
bered). 

Same as -htype except for footer. Default for logical page footer is n (no lines numbered). 

Do not restart numbering at logical page delimiters. 

Start# is the initial value used to number logical page lines. Default is 1. 

Incr is the increment value used to number logical page lines. Default is 1. 

Sep is the character(s) used in separating the line number and the corresponding text line. 
Default .sep is a tab. 

Width is the number of characters to be used for the line number. Default width is 6. 

Format is the line numbering format. Recognized values are: In, left justified, leading zeroes 
supressed; rn, right justified, leading zeroes supressed; rz, right justified, leading zeroes kept. 
Default/ormar is rn (right justified). 

Num is the number of blank lines to be considered as one. For example, -12 results in only the 
second adjacent blank being numbered (if the appropriate -ha, -ba, and/or -fa option is set). 
Default is 1. 

SEE ALSO 

pr(l). 


-htype 

-htype 

—itype 

-P 

-vstart# 

-iincr 

-ssep 

-wwidth 

—nformat 

—inum 
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NAME 

nm - print name list 
SYNOPSIS 

nm [ -gnoprsu ] [ file ... ] 

DESCRIPTION 

Nm prints the name list (symbol table) of each object file in the argument list. If an argument is an archive, 
a listing for each object file in the archive will be produced. If no file is given, the symbols in a.out are 
listed. 

Each symbol name is preceded by its value (blanks if undefined) and one of the letters U (undefined), A 
(absolute), T (text segment symbol), D (data segment symbol), B (bss segment symbol), R (register sym¬ 
bol), F (file symbol), or C (common symbol). If the symbol is local (non-external) the type letter is in 
lower case. The output is sorted alphabetically. 

Options are: 

-g Print only global (external) symbols. 

-n Sort numerically rather than alphabetically. 

-o Prepend file or archive element name to each output line rather than only once. This option can be 
used to make piping to grep(l) more meaningful. 

-p Don’t sort; print in symbol-table order. 

-r Sort in reverse order. 

-s Sort according to the size of the external symbol (computed from the difference between the value 
of the symbol and the value of the symbol with the next highest value). This difference is the 
value printed. This flag turns on -g and -n and turns off -u and -p. 

-u Print only undefined symbols. 

SEE ALSO 

ar(l), a.out(5), ar(5). 
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NAME 

nohup - run a command immune to hangups and quits 
SYNOPSIS 

nohup command [ arguments ] 

DESCRIPTION 

Nohup executes command with hangups and quits ignored. If output is not re-directed by the user, it will 
be sent to nohup.out. If nohup.out is not writable in the current directory, output is redirected to 

$HOME/nohup.out. 

SEE ALSO 

nice(l), signal(2). 



0D(1) 


OD(l) 


NAME 

od - octal dump 
SYNOPSIS 

od [ -bcdox ] [ file ] [ [ + ]offset[. ][ b ] ] 

DESCRIPTION 

Od dumps file in one or more formats as selected by the first argument. If the first argument is missing, -o 
is default. The meanings of the format options are: 

-b Interpret bytes in octal. 

-c Interpret bytes in ASCII. Certain non-graphic characters appear as C escapes: null=\0, 
backspace=\b, form-feed=\f, new-line=\n, return=\r, tab=\t; others appear as 3-digit octal numbers. 

-d Interpret words in decimal. 

-o Interpret words in octal. 

-X Interpret words in hex. 

The file argument specifies which file is to be dumped. If no file argument is specified, the standard input is 
used. 

The offset argument specifies the offset in the file where dumping is to commence. This argument is nor¬ 
mally interpreted as octal bytes. If. is appended, the offset is interpreted in decimal. If b is appended, the 
offset is interpreted in blocks of 512 bytes. If the file argument is omitted, the offset argument must be pre¬ 
ceded by +. 

Dumping continues until end-of-file. 

SEE ALSO 

adb(l). 
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NAME 

rjestat - RJE status and enquiries 
SYNOPSIS 

rjestat [-][ A] [B][C][U1][U2][U3] 

DESCRIPTION 

When invoked without the - argument, rjestat reports the current status of RJE links to the specified host 
computers. When invoked with the - argument, rjestat sets up an interactive status terminal. If no hosts 
are cited explicitly, the specification defaults to all those for which a given UNIX is configured. The 
“host” pseudonyms A, B, C, Ul, U2, and U3 are built into the RJE software. A, B, and C may be used to 
represent any IBM host machine. Their actual destinations are immaterial to RJE. The pseudonyms Ul, U2, 
and U3 are built into RJE to represent any UNIVAC host. 

To enter an enquiry via such a status terminal, you must first generate an interrupt. This can be done by hit¬ 
ting the DEL key or the BREAK/INTERRUPT key. Rjestat will respond by prompting for enquiries directed 
to each host in turn. The line on which a prompt appears may be completed to form a legitimate display 
command for that particular host. If the line is terminated with a \, the prompt will be repeated, otherwise it 
will advance to the next host. A carriage return alone indicates that no enquiry is to be directed to a particu¬ 
lar host. You should expect to wait at least 30 seconds for a response. 

An interrupt will temporarily halt the display of responses. It can therefore be used to inhibit roll-up on a 
CRT terminal. The display of responses will resume after all prompts have been satisfied (perhaps by null 
completions). 

To exit from the status terminal, generate a quit signal or type DEL followed by EOT. 

The interactive status enquiry capability is not supported for UNIVAC. 

FILES 

/dev/rje* DSQ-ll’s used by RJE 

/usr/rje/sys PWB/UNIX system name 

/usr/rje/lines configuration table 


And, in the directory for each RJE subsystem: 


log 

activity log 

resp 

concatenated responses 

status 

message of the day 

xmit* 

files queued 

*mesg 

enquiry slot 

*init 

boot program 


SEE ALSO 

Guide to IBM Remote Job Entry for PWB/UNIX Users by A. L. Sabsevitz and E. J. Finger. 
OS/VS2 HASP II Version 4 Operator’s Guide, IBM SRL #GC27-6993. 

Operator’s Library: OS/VS2 Reference (JES2), IBM SRL #GC38-0210. 



PACK(l) 


PACK(l) 


NAME 

pack, peat, unpack - compress and expand files 

SYNOPSIS 

pack [ - ] name ... 

peat name ... 
unpack name ... 

DESCRIPTION 

Pack attempts to store the specified files in a compressed form. Wherever possible (and useful), each input 
file name is replaced by a packed file nameji with the same access modes, access and modified dates, and 
owner as those of name. If pack is successful, name will be removed. Packed files can be restored to their 
original form using unpack or peat. 

Pack uses Huffman (minimum redundancy) codes on a byte-by-byte basis. If the - argument is used, an 
internal flag is set that causes the number of times each byte is used, its relative frequency, and the code for 
the byte to be printed on the standard output. Additional occurrences of - in place of name will cause the 
internal flag to be set and reset. 

The amount of compression obtained depends on the size of the input file and the character frequency dis¬ 
tribution. Because a decoding tree forms the first part of each .z file, it is usually not worthwhile to pack 
files smaller than three blocks, unless the character frequency distribution is very skewed, which may occur 
with printer plots or pictures. 

Typically, text files are reduced to 60-75% of their original size. Load modules, which use a larger charac¬ 
ter set and have a more uniform distribution of characters, show little compression, the packed versions 
being about 90% of the original size. 

Pack returns a value that is the number of files that it failed to compress. 

No packing will occur if: 

the file appears to be already packed; 

the file name has more than 12 characters; 

the file has links; 

the file is a directory; 

the file cannot be opened; 

no disk storage blocks will be saved by packing; 

a file called name.z already exists; 

the .z file cannot be created; 

an I/O error occurred during processing. 

The last segment of the file name must contain no more than 12 characters to allow space for the appended 
.z extension. Directories cannot be compressed. 

Peat does for packed files what cat{\.) does for ordinary files. The specified files are unpacked and written 
to the standard output. Thus to view a packed file named name.z use: 

peat name.z 

or just: 

peat name 

To make an unpacked copy, say nnn, of a packed file named name.z (without destroying name.z) use the 
command: 

peat name >nnn 

Peat returns the number of files it was unable to unpack. Failure may occur if: 

the file name (exclusive of the .z) has more than 12 characters; 

the file cannot be opened; 

the file does not appear to be the output of pack. 
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Unpack expands files created by pack. For each file name specified in the command, a search is made for a 
file called name.z (or just name, if name ends in .z). If this file appears to be a packed file, it is replaced by 
its expanded version. The new file has the .z suffix stripped from its name, and has the same access modes, 
access and modification dates, and owner as those of the packed file. 

Unpack returns a value that is the number of files it was unable to unpack. Failure may occur for the same 
reasons that it may in peat, as well as for the following: 

a file with the “unpacked” name already exists; 
if the unpacked file cannot be created. 
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NAME 

passwd - change login password 

SYNOPSIS 

passwd name 

DESCRIPTION 

This command changes (or installs) a password associated with the login name. 

The program prompts for the old password (if any) and then for the new one (twice). The caller must sup¬ 
ply these. New passwords should be at least four characters long if they use a sufficiently rich alphabet and 
at least six characters long if monocase. Only the first eight characters of the password are significant. 

Only the owner of the name or the super-user may change a password; the owner must prove he knows the 
old password. Only the super-user can create a null password. 

The password file is not changed if the new password is the same as the old password, or if the password 
has not “aged” sufficiently; see passwd{5)). 

FILES 

/etc/passwd 
SEE ALSO 

login(l), crypt(3C), passwd(5). 
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NAME 

paste - merge same lines of several files or subsequent lines of one file 

SYNOPSIS 

paste filel file2 ... 
paste -d list filel file2 ... 
paste -s [-d list ] file 1 file2 ... 

DESCRIPTION 

In the first two forms, paste concatenates corresponding lines of the given input files filel, file2, etc. It 
treats each file as a column or columns of a table and pastes them together horizontally (parallel merging). 
If you will, it is the counterpart of cat{l) which concatenates vertically, i.e., one file after the other. In the 
last form above, paste subsumes the function of an older command with the same name by combining sub¬ 
sequent lines of the input file (serial merging). In all cases, lines are glued together with the tab character, 
or with characters from an optionally specified list. Output is to the standard output, so it can be used as 
the start of a pipe, or as a filter, if - is used in place of a file name. 

The meanings of the options are: 

-d Without this option, the new-line characters of each but the last file (or last line in case of the -s 
option) are replaced by a tab character. This option allows replacing the tab character by one or 
more alternate characters (see below). 

list One or more characters immediately following -d replace the default tab as the line concatenation 
character. The list is used circularly, i. e. when exhausted, it is reused. In parallel merging (i. e. 
no -s option), the lines from the last file are always terminated with a new-line character, not from 
the list. The list may contain the special escape sequences: \n (new-line), \t (tab), W (backslash), 
and \0 (empty string, not a null character). Quoting may be necessary, if characters have special 
meaning to the shell (e.g. to get one backslash, use -d 'WW"). 

-s Merge subsequent lines rather than one from each input file. Use tab for concatenation, unless a 
list is specified with -d option. Regardless of the list, the very last character of the file is forced to 
be a new-line. 

- May be used in place of any file name, to read a line from the standard input. (There is no prompt¬ 

ing). 

EXAMPLES 

Is I paste -d"" - 

Is I paste- 

paste -s -d"\t\n" file 

SEE ALSO 

grep(l), cut(l), 

pr(l): pr -t -m... works similarly, but creates extra blanks, tabs and new-lines for a nice page layout. 

DIAGNOSTICS 

line too long 

too many files 


list directory in one column 
list directory in four columns 
combine pairs of lines into lines 


Output lines are restricted to 511 characters. 

Except for -s option, no more than 12 input files may be specified. 
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NAME 

pr - print files 

SYNOPSIS 

pr [ options ] [ files ] 

DESCRIPTION 

Pr prints the named files on the standard output. If file is or if no files are specified, the standard input is 
assumed. By default, the listing is separated into pages, each headed by the page number, a date and time, 
and the name of the file. 

By default, columns are of equal width, separated by at least one space; lines which do not fit are truncated. 
If the -s option is used, lines are not truncated and columns are separated by the separation character. 

If the standard output is associated with a terminal, error messages are withheld until pr has completed 
printing. 

Options may appear singly or be combined in any order. Their meanings are: 

+k Begin printing with page k (default is 1). 

-k Produce ^-column output (default is 1). The options -e and -i are assumed for multi-column out¬ 
put. 

-a Print multi-column output across the page. 

-m Merge and print all files simultaneously, one per column (overrides the -k, and -a options). 

-d Double-space the output. 

-eck Expand input tabs to character positions k+l, 2*k+\, 3*y^+l, etc. If /: is 0 or is omitted, default 
tab settings at every eighth position are assumed. Tab characters in the input are expanded into the 
appropriate number of spaces. If c (any non-digit character) is given, it is treated as the input tab 
character (default for c is the tab character). 

-ick In output, replace white space wherever possible by inserting tabs to character positions k+X, 
2*^+1, 3*^+1, etc. If ^ is 0 or is omitted, default tab settings at every eighth position are assumed. 
If c (any non-digit character) is given, it is treated as the output tab character (default for c is the 
tab character). 

-nek Provide ^-digit line numbering (default for k is 5). The number occupies the first ^+1 character 
positions of each column of normal output or each line of -m output. If c (any non-digit charac¬ 
ter) is given, it is appended to the line number to separate it from whatever follows (default for c is 
a tab). 

-wk Set the width of a line to k character positions (default is 72 for equal-width multi-column output, 
no limit otherwise). 

-ok Offset each line by k character positions (default is 0). The number of character positions per line 
is the sum of the width and offset. 

-\k Set the length of a page to k lines (default is 66). 

-h Use the next argument as the header to be printed instead of the file name. 

-p Pause before beginning each page if the output is directed to a terminal (pr will ring the bell at the 

terminal and wait for a carriage return). 

-f Use form-feed character for new pages (default is to use a sequence of line-feeds). Pause before 
beginning the first page if the standard output is associated with a terminal. 

-r Print no diagnostic reports on failure to open files. 

-t Print neither the five-line identifying header nor the five-line trailer normally supplied for each 

page. Quit printing after the last line of each file without spacing to the end of the page. 



PR(1) 


PR(1) 


-sc Separate columns by the single character c instead of by the appropriate number of spaces (default 
fore is a tab). 

EXAMPLES 

Print filel and file2 as a double-spaced, three-column listing headed by “file list”: 
pr -3dh "file list" filel file2 

Write filel on filel, expanding tabs to columns 10, 19, 28, 37,: 
pr -e9 -t <filel >file2 

FILES 

/dev/tty*to suspend messages 

SEE ALSO 

cat(l). 
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NAME 

prof - display profile data 
SYNOPSIS 

prof [ -V ] [ -a ] [ -1 ] [ -low [ -high ] ] [ file ] 

DESCRIPTION 

Prof interprets the file mon.out produced by the momtor(3C) subroutine. Under default modes, the symbol 
table in the named object file (a.out default) is read and correlated with the mon.out profile file. For each 
external symbol, the percentage of time spent executing between that symbol and the next is printed (in 
decreasing order), together with the number of times that routine was called and the number of milliseconds 
per call. 

If the -a option is used, all symbols are reported rather than just external symbols. If the -I option is used, 
the output is listed by symbol value rather than decreasing percentage. 

If the -V option is used, all printing is suppressed and a graphic version of the profile is produced on the 
standard output for display by the tplot(\G) filters. The optional arguments low and high, by default 0 and 
100, cause a selected percentage of the profile to be plotted with accordingly higher resolution. 

In order for the number of calls to a routine to be tallied, the -p option of cc must have been given when 
the file containing the routine was compiled. This option also arranges for the mon.out file to be produced 
automatically. 

FILES 

mon.out for profile 
a.out for namelist 

SEE ALSO 

cc(l), tplot(lG), profil(2), monitor(3C). 

BUGS 


Beware of quantization errors. 
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NAME 

prfld, prfstat, prfdc, prfsnap, prfpr - operating system profiler 

SYNOPSIS 

/etc/prfld [ namelist ] 

/etc/prfstat [ on I off ] 

/etc/prfdc [ period [ off_hour ] ] 

/etc/prfsnap file 

/etc/prfpr file [ cutoff [ namelist ] ] 

DESCRIPTION 

Prfld, prfstat, prfdc, prfsnap, and prfpr form a system of programs to facilitate an activity study of the 
UNIX operating system. 

Prfld is used to initialize the recording mechanism in the system. It generates a table containing the starting 
address of each system subroutine as extracted from namelist. 

Prfstat is used to enable or disable the sampling mechanism. Profiler overhead is less than 1% as calcu¬ 
lated for 500 text addresses. Prfstat will also reveal the number of text addresses being measured. 

Prfdc and prfsnap perform the data collection function of the profiler by copying the current value of all the 
text address counters to a file where the data can be analyzed. Prfdc will store the counters into file every 
period minutes and will turn off at offjiour. Prfsnap collects data at the time of invocation only, append¬ 
ing the counter values to file. 

Prfpr formats the data collected by prfdc or prfsnap. Each text address is converted to the nearest text 
symbol (as found in namelist) and is printed if the percent activity for that range is greater than cutoff. 

FILES 

/dev/prf interface to profile data and text addresses 
/unix default for namelist file 

SEE ALSO 

prf(4). 
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NAME 

prs - print an SCCS file 
SYNOPSIS 

prs [-d[dataspec]] [-r[SID]] [-e] [-1] [-a] files 
DESCRIPTION 

Prs prints, on the standard output, parts or all of an SCCS file (see sccsfile{5)) in a user supplied format. If 
a directory is named, prs behaves as though each file in the directory were specified as a named file, except 
that non-SCCS files (last component of the path name does not begin with s.), and unreadable files are 
silently ignored. If a name of - is given, the standard input is read; each line of the standard input is taken 
to be the name of an SCCS file or directory to be processed; non-SCCS files and unreadable files are silently 
ignored. 

Arguments to prs, which may appear in any order, consist of keyletter arguments, and file names. 

All the described keyletter arguments apply independently to each named file: 

-dldataspec] Used to specify the output data specification. The dataspec is a string consisting 
of SCCS file data keywords (see DATA KEYWORDS) interspersed with optional user 
supplied text. 

-r[5/D] Used to specify the 5CCS /Dentification (SID) string of a delta for which informa¬ 

tion is desired. If no SID is specified, the SID of the most recently created delta is 
assumed. 

-e Requests information for all deltas created earlier than and including the delta 

designated via the -r keyletter. 

-1 Requests information for all deltas created later than and including the delta desig¬ 

nated via the -r keyletter. 

-a Requests printing of information for both removed, i.e., delta type = R, (see 

rmdel(l)) and existing, i.e., delta type = D, deltas. If the -a keyletter is not 
specified, information for existing deltas only is provided. 

DATA KEYWORDS 

Data keywords specify which parts of an SCCS file are to be retrieved and output. All parts of an SCCS file 
(see sccsfile(5)) have an associated data keyword. There is no limit on the number of times a data keyword 
may appear in a dataspec. 

The information printed by prs consists of: (1) the user supplied text; and (2) appropriate values (extracted 
from the SCCS file) substituted for the recognized data keywords in the order of appearance in the 
dataspec. The format of a data keyword value is either Simple (S), in which keyword substitution is direct, 
or Multi-line (M), in which keyword substitution is followed by a carriage return. 

User supplied text is any text other than recognized data keywords. A tab is specified by \t and carriage 
return/new-line is specified by \n. 
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center expand ; c s s s s cl llw(20m) cll cll cIO c 1 c c c . TABLE 1. SCCS Files Data Keywords 

Keyword Data ItemFile Section Value Format :Dt: Delta information Delta Table See below* S 

:DL: T{ Delta line statistics T) " :Li:/:Ld:/:Lu: S :Li: T{ Lines inserted by Delta 

T) " nnnnn S :Ld: T{ Lines deleted by Delta T} " nnnnn S :Lu: T{ Lines 

unchanged by Delta T} " nnnnn S :DT: Delta type " Z) or/? S :I: T{ SCCS ID 

string (SID) T) " :R:.:L:.:B:.:S: S :R: Release number " nnnn S :L: Level 

number " nnnn S :B: Branch number " nnnn S :S: Sequence 

number " nnnn S :D: T{ Date Delta created T} " :Dy:/:Dm:/:Dd: S :Dy: T{ Year 

Delta created T} " nn S :Dm: T( Month Delta created T} " nn S :Dd: T( 

Day Delta created T} " nn S :T: T{ Time Delta created T} " :Th:::Tm:::Ts: S 

:Th: T{ Hour Delta created T} ” nn S :Tm: T{ Minutes Delta created 

T) " nn S :Ts: T{ Seconds Delta created T} " nn S :P: T{ Programmer 

who created Delta T} " logname S :DS: T{ Delta sequence number T} " nnnn S 

:DP: T{ Predecessor Delta seq-no. T} " nnnn S :DI: T{ Seq-no. of deltas inch, excl., ignored 

T) ■’ :Dn:/:Dx:/:Dg: S :Dn: Deltas included (seq #) ” :DS::DS:... S 

:Dx: Deltas excluded (seq #) ” :DS::DS:... S :Dg: Deltas ignored (seq 

#) " :DS::DS:... S :MR: MR numbers for delta " text M :C: Comments for 

delta" text M :UN: User names User Names text M :FL: Flag 

list Flags text M :Y: Module type flag " text S :MF: T( MR validation flag 

Tj " yes'or no S :MP: T( MR validation pgm name T} " text S :KF: T( Keyword 

error/warning flag T} " yes or no S :BF: Branch flag " yes or no S :J: Joint edit 

flag " yes or no S :LK: Locked releases " :R:... S :Q: User defined 

keyword " text S :M: Module name " text S :FB: Floor 

boundary " :R: S :CB: Ceiling boundary " :R: S :Ds: Default 

SID " :I: S :ND: Null delta flag " yes or no S :FD: T( File descriptive text 

T) Comments text M :BD: Body Body text M :GB: Gotten 

body " text M :W: T{ A form of H-/ior(l) string T) N/A :Z::M:\t:I: S :A: T( 

A form of what{l) string T} N/A :Z::Y: :M: :I::Z: S :Z: T{ what(l) string delimiter 

T) N/A @(#) S :F: SCCS file name N/A text S :PN: SCCS file path 

name N/A text S 

* :Dt: = :DT: :I: :D: :T: :P: :DS: :DP: 
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EXAMPLES 

prs -d"Users and/or user IDs for :F: are:\n:UN:" s.file 
may produce on the standard output: 

Users and/or user IDs for s.file are: 

xyz 

131 

abc 

prs -d"Newest delta for pgm :M:: :I: Created :D: By :P:" -r s.file 
may produce on the standard output: 

Newest delta for pgm main.c: 3.7 Created 77/12/1 By cas 
As a special case: 
prs s.file 

may produce on the standard output: 

D 1.1 77/12/1 00:00:00 cas 1 000000/00000/00000 
MRs: 

bl78-12345 

bl79-54321 

COMMENTS: 

this is the comment line for s.file initial delta 

for each delta table entry of the “D” type. The only keyletter argument allowed to be used with the special 
case is the -a keyletter. 

FILES 

/tmp/pr????? 

SEE ALSO 

admin(l), delta(l), get(l), help(l), sccsfile(5). 

Source Code Control System User’s Guide by L. E. Bonanni and C. A. Salemi. 

DIAGNOSTICS 

Use helpG) for explanations. 
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NAME 

ps - report process status 

SYNOPSIS 

ps [ options ] 


DESCRIPTION 

Ps prints certain information about active processes. Without options, information is printed about pro¬ 
cesses associated with the current terminal. Otherwise, the information that is displayed is controlled by 
the following options: 


-e 

-d 

-a 

-f 

-1 

-c corefile 
-s swapdev 

-n namelist 
-t tlist 


-p plist 
-u ulist 


-g gUst 


Print information about all processes. 

Print information about all processes, except process group leaders. 

Print information about all processes, except process group leaders and processes not associ¬ 
ated with a terminal. 

Generate a full listing. (Normally, a short listing containing only process ID, terminal 
(“tty”) identifier, cumulative execution time, and the command name is printed.) See 
below for meaning of columns in a full listing. 

Generate a long listing. See below. 

Use the file corefile in place of /dev/mem. 

Use the file swapdev in place of /dev/swap. This is useful when examining a corefile-, a 
swapdev of /dev/null will cause the user block to be zeroed out. 

The argument will be taken as the name of an alternate namelist (/unix is the default). 
Restrict listing to data about the processes associated with the terminals given in tlist, where 
tlist can be in one of two forms: a list of terminal identifiers separated from one another by a 
comma, or a list of terminal identifiers enclosed in double quotes and separated from one 
another by a comma and/or one or more spaces. 

Restrict listing to data about processes whose process ID numbers are given in plist, where 
plist is in the same format as tlist. 

Restrict listing to data about processes whose user ID numbers or login names are given in 
ulist, where ulist is in the same format as tlist. In the listing, the numerical user ID will be 
printed unless the -f option is used, in which case the login name will be printed. 

Restrict listing to data about processes whose process groups are given in glist, where glist 
is a list of process group leaders and is in the same format as tlist. 


The column headings and the meaning of the columns in a ps listing are given below; the letters f and 1 
indicate the option (full or long) that causes the corresponding heading to appear; all means that the head¬ 
ing always appears. Note that these two options only determine what information is provided for a process; 
they do not determine which processes will be listed. 

F (1) Flags (octal and additive) associated with the process: 

01 in core; 

02 system process; 

04 locked in core (e.g., for physical I/O); 

10 being swapped; 

20 being traced by another process. 

S (I) The state of the process: 

0 non-existent; 

S sleeping; 

W waiting; 

R running; 

I intermediate; 

Z terminated; 

T stopped. 

UID (f,l) The user ID number of the process owner; the login name is printed under the -f option. 
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PID 

(all) 

PPID 

(f,l) 

C 

(f,l) 

STIME 

(f) 

PRI 

(1) 

NI 

(1) 

ADDR 

(1) 

SZ 

(1) 

WCHAN 

(1) 

TTY 

(all) 

TIME 

(all) 

CMD 

(all) 


The process ID of the process; it is possible to kill a process if you know this datum. 

The process ID of the parent process. 

Processor utilization for scheduling. 

Starting time of the process. 

The priority of the process; higher numbers mean lower priority. 

Nice value; used in priority computation. 

The memory address of the process, if resident; otherwise, the disk address. 

The size in blocks of the core image of the process. 

The event for which the process is waiting or sleeping; if blank, the process is running. 
The controlling terminal for the process. 

The cumulative execution time for the process. 

The command name; the full command name and its arguments are printed under the -f 
option. 


A process that has exited and has a parent, but has not yet been waited for by the parent, is marked 

<defunct>. 


Under the -f option, ps tries to determine the command name and arguments given when the process was 
created by examining memory or the swap area. Failing this, the command name, as it would appear with¬ 
out the -f option, is printed in square brackets. 

FILES 

/unix system namelist 
/dev/mem memory 

/dev searched to find swap device and terminal (“tty”) names. 


SEE ALSO 

kill(l), nice(l). 


BUGS 

Things can change while ps is running; the picture it gives is only a close approximation to reality. Some 
data printed for defunct processes are irrelevant. 
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NAME 

ptx - permuted index 
SYNOPSIS 

ptx [ options ] [ input [ output ] ] 

DESCRIPTION 

Ptx generates a permuted index to file input on file output (standard input and output default). It has three 
phases: the first does the permutation, generating one line for each keyword in an input line. The keyword 
is rotated to the front. The permuted file is then sorted. Finally, the sorted lines are rotated so the keyword 
comes at the middle of each line. Ptx produces output in the form: 

.XX "tail" "before keyword" "keyword and after" "head” 

where .xx is assumed to be an nroff or trojf{l) macro provided by the user. The before keyword and 
keyword and after fields incorporate as much of the line as will fit around the keyword when it is printed. 
Tail and head, at least one of which is always the empty string, are wrapped-around pieces small enough to 
fit in the unused space at the opposite end of the line. 

The following options can be applied: 

-f Fold upper and lower case letters for sorting. 

-t Prepare the output for the phototypesetter. 

-w n Use the next argument, n, as the length of the output line. The default line length is 72 char¬ 

acters for nroff and 100 for troff. 

-g n Use the next argument, n, as the number of characters that ptx will reserve in its calculations 

for each gap among the four parts of the line as finally printed. The default gap is 3 charac¬ 
ters. 

-0 only Use as keywords only the words given in the only file. 

-i ignore Do not use as keywords any words given in the ignore file. If the -i and -o options are miss¬ 

ing, use /usr/Iib/eign as the ignore file. 

-b break Use the characters in the break file to separate words. Tab, new-line, and space characters are 
always used as break characters. 

-r Take any leading non-blank characters of each input line to be a reference identifier (as to a 

page or chapter), separate from the text of the line. Attach that identifier as a 5th field on each 
output line. 

The index for this manual was generated using ptx. 

FILES 

/bin/sort 

/usr/lib/eign 

BUGS 

Line length counts do not account for overstriking or proportional spacing. 

Lines that contain tildes (“) are botched, because ptx uses that character internally. 
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NAME 

pwck, grpck - password/group file checkers 

SYNOPSIS 

pwck [file] 
grpck [file] 

DESCRIPTION 

Pwck scans the password file and notes any inconsistencies. The checks include validation of the number 
of fields, login name, user ID, group ID, and whether the login directory and optional program name exist. 
The criteria for determining a valid login name are taken from Setting Up UNIX. The default password file 
is /etc/passwd. 

Grpck verifies all entries in the group file. This verification includes a check of the number of fields, group 
name, group ID, and whether all login names appear in the password file. The default group file is 

/etc/group. 

FILES 

/etc/group 

/etc/passwd 

SEE ALSO 

group(5), passwd(5). 

Setting Up UNIX. 

DIAGNOSTICS 

Group entries in /etc/group with no login names are flagged. 
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NAME 

pwd - working directory name 

SYNOPSIS 

pwd 

DESCRIPTION 

Pwd prints the path name of the working (current) directory. 

SEE ALSO 

cd(l). 

DIAGNOSTICS 

“Cannot open and “Read error in indicate possible file system trouble and should be referred to a 
UNIX programming counselor. 
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NAME 

ratfor - rational Fortran dialect 
SYNOPSIS 

ratfor [ options ] [ files ] 

DESCRIPTION 

Ratfor converts a rational dialect of Fortran into ordinary irrational Fortran. Ratfor provides control flow 
constructs essentially identical to those in C: 

statement grouping: 

{ statement; statement; statement} 

decision-making: 

if (condition) statement [ else statement ] 
switch (integer value) { 

case integer: statement 

[ default: ] statement 

1 

loops: 

while (condition) statement 

for (expression; condition; expression) statement 

do limits statement 

repeat statement [ until (condition) ] 

break 

next 

and some syntactic sugar to make programs easier to read and write: 
free form input: 

multiple statements/line; automatic continuation 

comments: 

# this is a comment. 

translation of relational: 

>, >=, etc., become .GT., .GE., etc. 

return expression to caller from function: 
return (expression) 

define: 

define name replacement 

include: 

include ji/e 

The option -h causes quoted strings to be turned into 27H constructs. The -C option copies comments to 
the output and attempts to format it neatly. Normally, continuation lines are marked with a & in column 1; 
the option -6x makes the continuation character x and places it in column 6. 

Ratfor is best used with/77(l). 

SEE ALSO 

efl(l),n7(l). 

B. W. Kernighan and P. J. Plauger, Software Tools, Addison-Wesley, 1976. 
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NAME 

reform - reformat text file 
SYNOPSIS 

reform [tabspecl [tabspec2]] [+bn] [+en] [+f] [+in] [+mn] [+pn] [+s] [+tn] 

DESCRIPTION 

Reform reads each line of the standard input file, reformats it, and then writes it to the standard output. 
Various combinations of reformatting operations can be selected, of which the most common involve rear¬ 
rangement of tab characters. It is often used to trim trailing blanks, truncate lines to a specified length, or 
prepend blanks to lines. 

Reform first scans its arguments, which may be given in any order. It then processes its input file, perform¬ 
ing the following actions upon each line, in the order given: 

- A line is read from the standard input. 

- If +s is given, all characters up to the first tab are stripped off and saved for later addition to the end of 
the line. Presumably, these characters comprise an “SCCS SID” produced by get{l). 

- The line is expanded into a tabless form, by replacing tabs with blanks according to the input tab 
specification tabspecl. 

- If -i-prt is given, n blanks are prepended to the line. 

- If +trt is given, the line is truncated to a length of n characters. 

- All trailing blanks are now removed. 

- If +en is included, the line is extended out with blanks to the length of n characters. 

- If +s is given, the previously-saved “SCCS SID” is added to the end of the line. 

- If +hn is given, the n characters at the beginning of the line are converted to blanks, if and only if all of 
them are either digits or blanks. 

- If +mn is included, the line is moved left, i.e., n characters are removed from the beginning of the line. 

- The line is now contracted by replacing some blanks with tab characters according to the list of tabs 
indicated by the output tab specification tabspecl, and is written to the standard output file. Option +i 
controls the method of contraction (see below). 

The various arguments accepted by reform are as follows: 

tabspecl describes the tab stops assumed for the input file. This tab specification may take on any of the 
forms described in tabs{l). In addition, the operand — indicates that the tab specification is to 
be found in the first line read from the standard input. If no legal tab specification is found 
there, -8 is assumed. If tabspecl is omitted entirely, — is assumed. 

tabspecl describes the tabs assumed for the output file. It is interpreted in the same way as tabspecl, 
except that omission of tabspecl causes the value of tabspecl to be used for tabspecl. 

The remaining arguments are all optional and may be used in any combination, although only a few com¬ 
binations make much sense. Specifying an argument causes an action to be performed, as opposed to the 
usual default of not performing the action. Some options include numeric values, which also have default 
values. Option actions are applied to each line in the order described above. Any line length mentioned 
applies to the length of a line just before the execution of the option described, and the terminating new- 
line is never counted in the line length. 

+bn causes the first n characters of a line to be converted to blanks, if and only if those characters 
include only blanks and digits. If n is omitted, the default value is 6, which is useful in delet¬ 
ing sequence numbers from COBOL programs. 

+e« causes each line shorter than n characters to be extended out with blanks to that length. Omit¬ 
ting n implies a default value of 72. This option is useful for those rare cases in which 
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sequence numbers need to be added to an existing unnumbered file. The use of $ in editor 
regular expressions is more convenient if all lines have equal length, so that the user can issue 
editor commands such as: 
s/$00001000/ 

+f causes a format line to be written to the standard output, preceding any other lines written. 

See fspec(5) for details regarding format specifications. The format line is taken from tah- 
spec2, i.e., the line normally appears as follows: 

<:i-tahspec2 d:> 

If tabspec2 is of the form — file-name (i.e., an indirect reference to a tab specification in the first line of 

the named file), then that tab specification line is written to the standard output. 

+m controls the technique used to compress interior blanks into tabs. Unless this option is 

specified, any sequence of 1 or more blanks may be converted to a single tab character if that 
sequence occurs just before a tab stop. This causes no problems for blanks that occur before 
the first nonblank character in a line, and it is always possible to convert the result back to an 
equivalent tabless form. However, occasionally an interior blank (one occurring after the first 
nonblank) is converted to a tab when this is not intended. For instance, this might occur in 
any program written in a language utilizing blanks as delimiters. Any single blank might be 
converted to a tab if it occurred just before a tab stop. Insertion or deletion of characters pre¬ 
ceding such a tab may cause it to be interpreted in an unexpected way at a later time. If the +i 
option is used, no string of blanks may be converted to a tab unless there are n or more con¬ 
tiguous blanks. The default value is 2. Note that leading blanks are always converted to tabs 
when possible. It is recommended that conversion of programs from non -UNIX to UNIX sys¬ 
tems use this option. 

+mn causes each line to be moved lift n characters, with a default value of 6. This can be useful 
for crunching COBOL programs. 

+pn causes n blanks to be prepended (default of 6 if n is omitted). This option is effectively the 
inverse of +mn, and is often useful for adjusting the position of nroff(l) output for terminals 
lacking both forms tractor positioning and a settable left margin. 

+s is used with the -m option of get(l). The -m option causes get to prepend to each generated 

line the appropriate SCCS SID, followed by a tab. The +s option causes reform to remove the 
SID from the front of the line, save it, then add it later to the end of the line. Because +e72 is 
implied by this option, the effect is to produce 80-character card images with SCCS SID in 
columns 73-80. Up to 8 characters of the SID are shown; if it is longer, the eighth character is 
replaced by * and any characters to the right of it are discarded. 

+t« causes any line longer than n characters to be truncated to that length. If n is omitted, the 

length defaults to 72. Sequence numbers can thus be removed and any blanks immediately 
preceding them deleted. 

The following illustrate typical uses of reform. The terms PWB and OBJECT below refer to UNIX and 
non- UNIX computer systems, respectively. Each arrow indicates the direction of conversion. The charac¬ 
ter ? indicates an arbitrary tab specification; see tabs{\) for descriptions of legal specifications. 
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OBJECT-> PWB (i.e., manipulation of RJE output): 

Note that files transferred by RJE from OBJECT to PWB materialize with format -8. 

reform -8 -c +t +b +i <oldfile >newfile (into COBOL) 

reform -8 -c3 +t +m +i <oldfile >newfile (into COBOL, crunched) 

NOTE: -c3 is the preferred format COBOL; it uses the least disk space of the COBOL formats. 

PWB-> OBJECT (i.e., preparation of files for RJE submission): 

reform ? -8 <oldfile >newfile (from arbitrary format into -8) 
get -p -m sccsfile | reform +s | send ... 

PWB ONLY (i.e., no involvement with other systems): 

pr file I reform ? -0 <oldfile (print on terminal without hardware tabs) 
reform ? -0 <oldfile >newfile (convert file to tabless format) 

DIAGNOSTICS 

All diagnostics are fatal, and the offending line is displayed following the message. 

“line too long” a line exceeds 512 characters (in tabless form). 

‘ ‘not sees -m’ ’ a line does not have at least one tab when +s flag is used. 

Any of the diagnostics of tabs{\) can also appear. 

EXIT CODES 

0 - normal 
1 - any error 

SEE ALSO 

get(l), nroff(l), send(lC), tabs(l), fspec(5). 

BUGS 

Reform is aware of the meanings of backspaces and escape sequences, so that it can be used as a postpro¬ 
cessor for nroff. However, be warned that the +e, +m, and +t options only count characters, not positions. 
Anyone using these options on output containing backspaces or halfline motions will probably obtain unex¬ 
pected results. 
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NAME 

regcmp - regular expression compile 

SYNOPSIS 

regcmp [ - ] files 

DESCRIPTION 

Regcmp, in most cases, precludes the need for calling regcmp (see regex(3X)) from C programs. This 
saves on both execution time and program size. The command regcmp compiles the regular expressions in 
file and places the output in file i. If the - option is used, the output will be placed in file.c. The format of 
entries in file is a name (C variable) followed by one or more blanks followed by a regular expression 
enclosed in double quotes. The output of regcmp is C source code. Compiled regular expressions are rep¬ 
resented as extern char vectors. File.i files may thus be included into C programs, or file.c files may be 
compiled and later loaded. In the C program which uses the regcmp output, regex(ahc,line) will apply the 
regular expression named abc to line. Diagnostics are self-explanatory. 

EXAMPLES 

name "([A-Za-z][A-Za-z0-9_]*)$0" 

telno ’'\({0,1}([2-9][01][1-9])$0\){0,1} 

'■([2-9][0-9]{2))$l[-]{0,l}” 

'■([0-9]{4})$2" 

In the C program that uses the regcmp output, 
regex(telno, line, area, exch, rest) 
will apply the regular expression named telno to line. 

SEE ALSO 

regex(3X). 
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NAME 

restor - incremental file system restore 
SYNOPSIS 

restor key [ arguments ] 

DESCRIPTION 

Restor is used to read magnetic tapes dumped with the dump command. The key specifies what is to be 
done. Key is one of the characters rRxt, optionally combined with f. 

f Use the first argument as the name of the tape instead of the default. 

r or R The tape is read and loaded into the file system specified in argument. This should not be done 
lightly (see below). If the key is R, restor asks which tape of a multi-volume set to start on. This 
allows restor to be interrupted and then restarted {mfsck must be done before the restart). 

X Each file on the tape named by an argument is extracted. The file name has all “mount” prefixes 

removed; for example, if /usr is a mounted file system, /usr/bin/Ipr is named /bin/lpr on the tape. 
The extracted file is placed in a file with a numeric name supplied by restor (actually the inode 
number). In order to keep the amount of tape read to a minimum, the following procedure is rec¬ 
ommended: 

1. Mount volume 1 of the set of dump tapes. 

2. Type the restor command. 

3. Restor will announce whether or not it found the files, give the numeric name that it will 
assign to the file, and rewind the tape. 

4. It then asks you to “mount the desired tape volume”. Type the number of the volume 
you choose. On a multi-volume dump the recommended procedure is to mount the last 
through the first volumes, in that order. Restor checks to see if any of the requested files 
are on the mounted tape (or a later tape-thus the reverse order) and doesn’t read through 
the tape if no files are. If you are working with a single-volume dump or if the number of 
files being restored is large, respond to the query with 1 and restor will read the tapes in 
sequential order. 

t Print the date the tape was written and the date the file system was dumped from. 

The r option should only be used to restore a complete dump tape onto a clear file system, or to restore an 
incremental dump tape onto a file system so created. Thus: 

/etc/mkfs /dev/rpO 40600 
restor r /dev/rpO 

is a typical sequence to restore a complete dump. Another restor can be done to get an incremental dump 
in on top of this. 

A dump followed by a mkfs and a restor is used to change the size of a file system. 

FILES 

default tape unit varies with installation 
rst* 

SEE ALSO 

dump(lM), fsck(lM), mkfs(lM). 

DIAGNOSTICS 

There are various diagnostics involved with reading the tape and writing the disk. There are also diagnos¬ 
tics if the i-list or the free list of the file system is not large enough to hold the dump. 

If the dump extends over more than one tape, it may ask you to change tapes. Reply with a new-line when 
the next tape has been mounted. 
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BUGS 

There is redundant information on the tape that could be used in case of tape reading problems. Unfortu¬ 
nately, restor doesn’t use it. 
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NAME 

rjestat - RJE status report and interactive status console 
SYNOPSIS 

rjestat [ host ]... [ -shost ] [ -chost cmd ]... 

DESCRIPTION 

Rjestat provides a method of determining the status of an RJE link and of simulating an IBM remote console 
(with UNIX features added). When invoked with no arguments, rjestat reports the current status of all the 
RJE links connected to to the UNIX system. The options are: 

host Print the status of the line to host. Host is the pseudonym for a particular IBM system. It can 

be any name that corresponds to one in the first column of the RJE configuration file. 

-shost After all the arguments have been processed, start an interactive status console to host. 

-chost cmd Interpret cmd as if it were entered in status console mode to host. See below for the proper for¬ 
mat of cmd. 

In status console mode, rjestat prompts with the host pseudonym followed by : whenever it is ready to 
accept a command. Commands are terminated with a new-line. A line that begins with ! is sent to the 
UNIX shell for execution. A line that begins with the letter q terminates rjestat. All other input lines are 
assumed to have the form: 

ibmcmd [ redirect ] 

Ibmcmd is any IBM JES or HASP command. Only the super-user or rje login can send commands other 
than display or inquiry commands. Redirect is a pipeline or a redirection to a file (e.g., “> file” or ” | grep 
...”). The IBM response is written to the pipeline or file. If redirect is not present, the response is written 
to the standard output of rjestat. 

An interrupt signal (DEL or BREAK) will cancel the command in progress and cause rjestat to return to the 
command input mode. 

EXAMPLE 

The following command reports the status of all the card readers attached to host A, remote 5. JES2 is 
assumed. 

rjestat -cA '$du,rmt5 I grep RD' 

DIAGNOSTICS 

The message “RJE error: ...” indicates that rjestat found an inconsistency in the RJE system. This may be 
transient but should be reported to the site administrator. 

FILES 

/usr/rje/lines RJE configuration file 

resp host response file that exists in the RJE subsystem directory (e.g., /usr/rjel). 

SEE ALSO 

send(lC), rje(8). 

OSA^S2 HASP II Version 4 Operator’s Guide, IBM SRL #GC27-6993. 

Operator's Library: OSA^S2 Reference (JES2), IBM SRL #GC38-0210. 
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NAME 

rm, rmdir - remove files or directories 

SYNOPSIS 

rm [-M] file ... 

rmdir dir... 

DESCRIPTION 

Rm removes the entries for one or more files from a directory. If an entry was the last link to the file, the 
file is destroyed. Removal of a file requires write permission in its directory, but neither read nor write per¬ 
mission on the file itself. 

If a file has no write permission and the standard input is a terminal, its permissions are printed and a line is 
read from the standard input. If that line begins with y the file is deleted, otherwise the file remains. No 
questions are asked when the -f option is given or if the standard input is not a terminal. 

If a designated file is a directory, an error comment is printed unless the optional argument -r has been 
used. In that case, rm recursively deletes the entire contents of the specified directory, and the directory 
itself. 

If the -i (interactive) option is in effect, rm asks whether to delete each file, and, under -r, whether to 
examine each directory. 

Rmdir removes entries for the named directories, which must be empty. 

SEE ALSO 

unlink(2). 

DIAGNOSTICS 

Generally self-explanatory. It is forbidden to remove the file .. merely to avoid the antisocial consequences 
of inadvertently doing something like: 


rm -r .* 
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NAME 

rmdel - remove a delta from an SCCS file 

SYNOPSIS 

rmdel -rSID files 

DESCRIPTION 

Rmdel removes the delta specified by the SID from each named SCCS file. The delta to be removed must be 
the newest (most recent) delta in its branch in the delta chain of each named SCCS file. In addition, the 
specified must not be that of a version being edited for the purpose of making a delta (i. e., if a p-file (see 
get{l)) exists for the named SCCS file, the specified must not appear in any entry of the p-jile). 

If a directory is named, rmdel behaves as though each file in the directory were specified as a named file, 
except that non-SCCS files (last component of the path name does not begin with s.) and unreadable files 
are silently ignored. If a name of - is given, the standard input is read; each line of the standard input is 
taken to be the name of an SCCS file to be processed; non-SCCS files and unreadable files are silently 
ignored. 

The exact permissions necessary to remove a delta are documented in the Source Code Control System 
User’s Guide. Simply stated, they are either (1) if you make a delta you can remove it; or (2) if you own 
the file and directory you can remove a delta. 

FILES 

x-file (see delta{\)) 

z-file (see delta{\)) 

SEE ALSO 

delta(l), getf 1), help(l), prs(l), sccsfile(5). 

Source Code Control System User’s Guide by L. E. Bonanni and C. A. Salemi. 

DIAGNOSTICS 

Use helpG) for explanations. 
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NAME 

rsh - restricted shell (command interpreter) 

SYNOPSIS 

rsh [ flags ] [ name [ argl ... ] ] 

DESCRIPTION 

Rsh is a restricted version of the standard command interpreter It is used to set up login names and 

execution environments whose capabilities are more controlled than those of the standard shell. The 
actions of rsh are identical to those of sh, except that the following are disallowed: 

cd 

setting the value of $PATH 
command names containing / 

> and » 

When invoked with the name -rsh, rsh reads the user’s .profile (from $HOME/.profile). It acts as the stan¬ 
dard sh while doing this, except that an interrupt causes an immediate exit, instead of causing a return to 
command level. The restrictions above are enforced after .profile is interpreted. 

When a command to be executed is found to be a shell procedure, rsh invokes sh to execute it. Thus, it is 
possible to provide to the end user shell procedures that have access to the full power of the standard shell, 
while restricting him to a limited menu of commands; this scheme assumes that the end user does not have 
write and execute permissions in the same directory. 

The net effect of these rules is that the writer of the .profile has complete control over user actions, by per¬ 
forming guaranteed setup actions, then leaving the user in an appropriate directory (probably not the login 
directory). 

Rsh is actually just a link to sh and any flags arguments are the same as for i'/?(l). 

The system administrator often sets up a directory of commands that can be safely invoked by rsh. Some 
systems also provide a restricted editor red. 

SEE ALSO 

sh(l), profile(5). 
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NAME 

runacct - run daily accounting 
SYNOPSIS 

runacct [mmdd [state]] 

DESCRIPTION 

Runacct is the main daily accounting shell procedure. It is normally initiated via cra«(lM). Runacct pro¬ 
cesses connect, fee, disk, and process accounting files. It also prepares summary files for prdaily or billing 
purposes. 

Runacct takes care not to damage active accounting files or summary files in the event of errors. It records 
its progress by writing descriptive diagnostic messages into active. When an error is detected, a message is 
written to /dev/console, mail (see mail{\)) is sent to root and adm, and runacct terminates. Runacct uses a 
series of lock files to protect against re-invocation. The files lock and lockl are used to prevent simultane¬ 
ous invocation, and lastdate is used to prevent more than one invocation per day. 

Runacct breaks its processing into separate, restartable states using statefile to remember the last state 
completed. It accomplishes this by writing the state name into statefile. Runacct then looks in statefile to 
see what it has done and to determine what to process next. States are executed in the following order: 

SETUP Move active accounting files into working files. 

WTMPFIX Verify integrity of wtmp file, correcting date changes if necessary. 

CONNECTl Produce connect session records in ctmp h format. 

CONNECT2 Convert ctmp.h records into tacct.h format. 

PROCESS Convert process accounting records into tacct h format. 

MERGE Merge the connect and process accounting records. 

FEES Convert output of chargefee into tacct.h format and merge with connect and pro¬ 

cess accounting records. 

DISK Merge disk accounting records with connect, process, and fee accounting records. 

MERGETACCT 

Merge the daily total accounting records in daytacct with the summary total 
accounting records in /usr/adm/acct/sum/tacct. 

CMS Produce command summaries. 

USEREXIT Any installation-dependent accounting programs can be included here. 

CLEANUP Cleanup temporary files and exit. 

To restart runacct after a failure, first check the active file for diagnostics, then fix up any corrupted data 
files such as pacct or wtmp. The lock files and lastdate file must be removed before runacct can be res¬ 
tarted. The argument mmdd is necessary if runacct is being restarted, and specifies the month and day for 
which runacct will rerun the accounting. Entry point for processing is based on the contents of statefile; to 
override this, include the desired state on the command line to designate where processing should begin. 

EXAMPLES 

To start runacct. 

nohup runacct 2> /usr/adm/acct/nite/fd21og & 

To restart runacct. 

nohup runacct 0601 2» /usr/adm/acct/nite/fd21og & 

To restart runacct at a specific state. 

nohup runacct 0601 MERGE 2» /usr/adm/acct/nite/fd21og & 

FILES 


/usr/lib/acct/runacct 
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/usr/adm/wtmp 
/usr/adm/pacct[ 1 -9] 

/usr/src/cmd/acct/tacct h 

/usr/src/cmd/acct/ctmp.h 

/usr/adm/acct/nite/active 

/usr/adm/acct/nite/daytacct 

/usr/adm/acct/nite/lock 

/usr/adm/acct/nite/lockl 

/usr/adm/acct/nite/lastdate 

/usr/adm/acct/nite/statefile 

/usr/adm/acct/nite/ptacct[ 1 -9] .mmdd 

SEE ALSO 

acct(lM), acctcms(lM), acctcom(l), acctcon(lM), acctmerg(lM), acctprc(lM), acctsh(lM), cron(lM), 
fwtmp(lM), acct(2), acct(5), utmp(5). 

The UNIX Accounting System by H. S. McCreary. 

DIAGNOSTICS 

Self explanatory. 

BUGS 

Normally it is not a good idea to restart runacct in the SETUP state. Run SETUP manually and restart via: 
runacct mmdd WTMPFIX 

If runacct failed in the PROCESS state, remove the last placet file because it will not be complete. 
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NAME 

sact - print current SCCS file editing activity 

SYNOPSIS 

sact files 

DESCRIPTION 

Sact informs the user of any impending deltas to a named SCCS file. This situation occurs when get{\) 
with the -e option has been previously executed without a subsequent execution of delta{\). If a directory 
is named on the command line, sact behaves as though each file in the directory were specified as a named 
file, except that non-SCCS files and unreadable files are silently ignored. If a name of - is given, the stan¬ 
dard input is read with each line being taken as the name of an SCCS file to be processed. 

The output for each named file consists of five fields separated by spaces. 

Field 1 specifies the SID of a delta that currently exists in the SCCS file to which changes will 

be made to make the new delta. 

Field 2 specifies the SID for the new delta to be created. 

Field 3 contains the logname of the user who will make the delta (i.e. executed a get for edit- 

ing). 

Field 4 contains the date that get -e was executed. 

Field 5 contains the time that get -e was executed. 

SEE ALSO 

delta(l), get(l), unget(l). 

DIAGNOSTICS 

Use help{\.) for explanations. 
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NAME 

sag - system activity graph 
SYNOPSIS 

sag [ -s time ] [ -e time ] [ -T term ] [ -uirwcohdpaf ] [ file ] 

DESCRIPTION 

Sag displays, in a graphical form, the system activity of the UNIX operating system during a specified time 
interval. File is the file that contains the daily system activity information, default is /usr/adm/sa/sa^fJ, 
where dd is today’s day of the month. Sag has the following options: 

-s time Begin graph at time specified as hh:mm. Default is 08:00. 

-e time End graph at time specified as hh:mm. Default is 18:00. 

-T term Translate output to a form suitable for terminal term. If this option is not used, the environ¬ 
ment variable $TERM (see environij)) is used. Refer to tplot{\G) for available types of ter¬ 
minals. 

-u Plot CPU utilization, showing proportion of user, system and idle time (default option). 

-i Plot percent of time the CPU was idle and waiting on block I/O, waiting on swap in or swap 

out, or waiting on physical I/O. 

-r Plot logical reads/minute and block reads/minute. 

-w Plot logical writes/minute and block writes/minute. 

-c Plot buffer cache hit ratios for reads and for writes. 

-o Plot block transfer rate between system buffers and devices, showing reads/minute, 

writes/minute, and the sum of reads and writes/minute. 

-h Plot bytes read/second by system call read{2) and bytes written/second by system call 

write{2). 

-d Plot the sum of reads and writes/minute for each of the first three RP06 type disk drives. 

-p Plot process switches/second, process preemptions/second and system calls/second. 

-a Plot process swapins/minute and process swapouts/minute. 

-f Plot file access activities: iget/second, namei/second, and directory blocks read/second. 

FILES 

/usr/adm/sa/saJJ daily data file, where dd are digits representing the day of the month. 

SEE ALSO 

graph(lG), tplot(lG), sar(8). 

NOTES 

Plotted data points are extracted from the system activity file, /usr/adm/sa/sai/J, which is written under the 
control of cron{\M), normally every 20 minutes between 8:00 and 18:00 on weekdays, and hourly at other 
times. 

In the event of a system outage, the system activity counters are reset to zero when the system is rebooted. 
This discontinuity is shown by a gap in the plotted data. 

DIAGNOSTICS 

“terminal type not known” 

if $TERM is not set and the -T option is not specified. 
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NAME 

see - C eompiler for stand-alone programs 
SYNOPSIS 

see [ +[ lib ] ] [ option ] ... [ file ] ... 

DESCRIPTION 

See prepares the named files for stand-alone exeeution. The option and file arguments may be anything 
that ean legally be used with the ee eommand; it should be noted, though, that the -p (profiling) option, as 
well as any objeet module that eontains system ealls, will eause the exeeutable not to run. 

See defines the compiler constant, STANDALONE, so that sections of C programs may be compiled condi¬ 
tionally for when the executable will be run stand-alone. 

The first argument specifies an auxiliary library that defines the device configuration of the PDP-11 com¬ 
puter for which the stand-alone executable is being prepared. Lib may be one of the following: 

A RP04/05/06 disk and TU16 magnetic tape, or equivalent 

B RKl 1/RK05 disk, RPl 1/RP03 disk, and TMl 1/TU16 magnetic tape, or equivalent 

If no -^lib argument is specified, +A is assumed. If the + argument is specified alone, no configuration 
library is loaded unless the user supplies his own. 


FILES 


/lib/crt20.o 

/usr/lib/lib2.a 

/usr/lib/lib2A.a 

/usr/lib/lib2B.a 


execution start-off 
stand-alone library 
-i-A configuration library 
-i-B configuration library 


(PDP-11 only) 
(PDP-11 only) 


SEE ALSO 

cc(l), ld(l), a.out(5). 

A Stand-alone Input/Output Library, by S. R. Eisen. 
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NAME 

sccsdiff - compare two versions of an SCCS file 
SYNOPSIS 

sccsdiff-rSID 1 -rSID2 [-p] [-sn] files 


DESCRIPTION 

Sccsdiff compares two versions of an SCCS file and generates the differences between the two versions. 
Any number of SCCS files may be specified, but arguments apply to all files. 

-rSID? SIDl and SID2 specify the deltas of an SCCS file that are to be compared. Versions are 

passed to bdiff{V) in the order given. 

-p pipe output for each file through/?r(l). 

-sn n is the file segment size that bdiff will pass to diff{\). This is useful when diff fails 

due to a high system load. 


FILES 

/tmp/get????? Temporary files 


SEE ALSO 

bdiff(l), get(l), help(l), pr(l). 

Source Code Control System User’s Guidehy L. E. Bonanni and C. A. Salemi. 


DIAGNOSTICS 

''file: No differences” If the two versions are the same. 

Use help{\) for explanations. 
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NAME 

sdb - symbolic debugger 
SYNOPSIS 

sdb [ objfil [ corfil [ directory ] ] ] 

DESCRIPTION 

Sdb is a symbolic debugger which can be used with C and F77 programs. It may be used to examine their 
files and to provide a controlled environment for their execution. 

Objfil is an executable program file which has been compiled with the -g (debug) option. The default for 
objfil is a.out. Corfil is assumed to be a core image file produced after executing objfil; the default for 
corfil is core. The core file need not be present. 

It is useful to know that at any time there is a current line and current file. If corfil exists then they are ini¬ 
tially set to the line and file containing the source statement at which the process terminated or stopped. 
Otherwise, they are set to the first line in mainQ. The current line and file may be changed with the source 
file examination commands. 

Names of variables are written just as they are in C or F77. Variables local to a procedure may be accessed 
using the form procedureivariable. If no procedure name is given, the procedure containing the current 
line is used by default. It is also possible to refer to structure members as variable.member, pointers to 
structure members as variable->member and array elements as variable[number]. Combinations of these 
forms may also be used. 

It is also possible to specify a variable by its address. All forms of integer constants which are valid in C 
may be used, so that addresses may be input in decimal, octal or hexadecimal. 

Line numbers in the source program are referred to file-name‘.number or procedure‘.number. In either 
case the number is relative to the beginning of the file. If no procedure or file name is given, the current file 
is used by default. If no number is given, the first line of the named procedure or file is used. 

The commands for examining data in the program are: 
t Print a stack trace of the terminated or stopped program. 

T Print the top line of the stack trace. 
variable/lm 

Print the value of variable according to length / and format m. If / and m are omitted, sdb chooses a 
length and format suitable for the variable’s type as declared in the program. The length specifiers 
are: 

b one byte 

h two bytes (half word) 

1 four bytes (long word) 

number string length for formats s and a 

Legal values for m are: 

c character 

d decimal 

u decimal, unsigned 

o octal 

X hexadecimal 

f 32 bit single precision floating point 

g 64 bit double precision floating point 

s Assume variable is a string pointer and print characters starting at the address 

pointed to by the variable. 

a Print characters starting at the variable’s address, 

p pointer to procedure 

The length specifiers are only effective with the formats d, u, o and x. If one of these formats is 
specified and / is omitted, the length defaults to the word length of the host machine; 4 for the 
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11/780. If a numeric length specifier is used for the s or a command then that many characters are 
printed. Otherwise successive characters are printed until either a null byte is reached or 128 charac¬ 
ters are printed. The last variable may be redisplayed with the command ./. 

The sh(l) metacharacters * and ? may be used within procedure and variable names, providing a lim¬ 
ited form of pattern matching. If no procedure name is given, both variables local to the current pro¬ 
cedure and global (common for F77) variables are matched, while if a procedure name is specified 
then only variables local to that procedure and matched. To match only global variables (or blank 
common for F77), the form ’.pattern is used. The name of a common block may be specified instead 
of a procedure name for F77 programs. 
variahle=lm 
linenumber=lm 
number=lm 

Print the address of variable or linenumber, or the value of number in the format specified by Im. If 
no format is given, then lx is used. The last variant of this command provides a convenient way to 
convert between decimal, octal and hexadecimal. 

variablelvalue 

Set variable to the given value. The value may be a number, character constant or a variable. If the 
variable is of type float or double, the value may also be a floating constant. 

The commands for examining source files are: 

e procedure 
e file-name 

Set the current file to the file containing procedure or to file-name. Set the current line to the first 
line in the named procedure or file. If no procedure or file name is given, the current procedure and 
file names are reported. 

Iregular expression! 

Search forward from the current line for a line containing a string matching regular expression as in 
ed{\). The trailing / may be elided. 

?regular expression? 

Search backward from the current line for a line containing a string matching regular expression as 
in ed(l). The trailing ? may be elided. 

p Print the current line. 

z Print the current line followed by the next 9 lines. Set the current line to the last line printed. 

control-D 

Scroll. Print the next 10 lines. Set the current line to the last line printed, 
w Window. Print the 10 lines around the current line. 
number 

Set the current line to the given line number. Print the new current line. 
count+ 

Advance the current line by count lines. Print the new current line. 
count— 

Retreat the current line by count lines. Print the new current line. 

The commands for controlling the execution of the source program are: 

count r args 
count R 

Run the program with the given arguments. The r command with no arguments reuses the previous 
arguments to the program while the R command runs the program with no arguments. An argument 
beginning with < or > causes redirection for the standard input or output respectively. If count is 
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given, it specifies the number of breakpoints to be ignored. 

linenumber c count 
linenumber C count 

Continue after a breakpoint or interrupt. If count is given, it specifies the number of breakpoints to 
be ignored. C continues with the signal which caused the program to stop and c ignores it. If a 
linenumber is specified then a temporary breakpoint is placed at the line and execution is continued. 
The breakpoint is deleted when the command finishes. 

linenumber g count 

Continue after a breakpoint with execution resumed at the given line. If count is given, it specifies 
the number of breakpoints to be ignored. 

count s 

Single step. Run the program through count lines. If no count is given then the program is run for 
one line. 

count S 

Single step, but step through subroutine calls, 
k Kill the debugged program. 

procedure(arg 1 ,arg2,...) 
procedure(arg 1 ,arg2,.. .)/m 

Execute the named procedure with the given arguments. Arguments can be integer, character or 
string constants or names of variables accessible from the current procedure. The second form causes 
the value returned by the procedure to be printed according to format m. If no format is given, it 
defaults to d. 

linenumber b commands 

Set a breakpoint at the given line. If a procedure name without a line number is given (e.g. “proc:”), 
a breakpoint is placed at the first line in the procedure even if it was not compiled with the debug 
flag. If no linenumber is given, a breakpoint is placed at the current line. If no commands are given 
then execution stops just before the breakpoint and control is returned to sdb. Otherwise the 
commands are executed when the breakpoint is encountered and execution continues. Multiple com¬ 
mands are specified by separating them with semicolons. 

B Print a list of the currently active breakpoints. 
linenumber d 

Delete a breakpoint at the given line. If no linenumber is given then the breakpoints are deleted inter¬ 
actively: Each breakpoint location is printed and a line is read from the standard input. If the line 
begins with a y or d then the breakpoint is deleted. 

D Delete all breakpoints. 

1 Print the last executed line. 

linenumber a 

Announce. If linenumber is of the form procinumber, the command effectively does a linenumber b 
1. If linenumber is of the form proc:, the command effectively does a proci b T. 

Miscellaneous commands: 

[command 

The command is interpreted by j'/i(l). 

new-line 

If the previous command printed a source line then advance the current line by 1 line and print the 
new current line. If the previous command displayed a core location then display the next core loca¬ 
tion. 
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" string 

Print the given string, 
q Exit the debugger. 

The following commands also exist and are intended only for debugging the debugger: 

V Print the version number. 

X Print a list of procedures and files being debugged. 

Y Toggle debug output. 

FILES 

a.out 

core 

SEE ALSO 

adb(l), a.out(5), core(5). 

DIAGNOSTICS 

Error reports are either identical to those of adb(\) or are self-explanatory. 

BUGS 

If a procedure is called when the program is not stopped at a breakpoint (such as when a core image is 
being debugged), all variables are initialized before the procedure is started. This makes it impossible to 
use a procedure which formats data from a core image. 

Arrays must be of one dimension and of zero origin to be correctly addressed by sdb. 

The default type for printing F77 parameters is incorrect. Their address is printed instead of their value. 

Tracebacks containing F77 subprograms with multiple entry points may print too many arguments in the 
wrong order, but their values are correct. 
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NAME 

sdiff - side-by-side difference program 
SYNOPSIS 

sdiff [ options ... ] filel file2 
DESCRIPTION 

Sdiff uses the output of diff(\) to produce a side-by-side listing of two files indicating those lines that are 
different. Each line of the two files is printed with a blank gutter between them if the lines are identical, a < 
in the gutter if the line only exists in filel , a > in the gutter if the line only exists in file2, and a I for lines 
that are different. 

For example: 


The following options exist; 
-w n 


-o output 


Use the next argument, «, as the width of the output line. The default line length is 130 char¬ 
acters. 

Only print the left side of any lines that are identical. 

Do not print identical lines. 

Use the next argument, output, as the name of a third file that is created as a user controlled 
merging of file! and file2. Identical lines oi filel andji/^2 are copied to output. Sets of dif¬ 
ferences, as produced by diffifi), are printed; where a set of differences share a common gutter 
character. After printing each set of differences, sdiff prompts the user with a % and waits 
for one of the following user-typed commands: 


1 


e 1 
e r 
e b 


append the left column to the output file 

append the right column to the output file 

turn on silent mode; do not print identical lines 

turn off silent mode 

call the editor with the left column 

call the editor with the right column 

call the editor with the concatenation of left and right 

call the editor with a zero length file 

exit from the program 


On exit from the editor, the resulting file is concatenated on the end of the output file. 


SEE ALSO 

diff(l), ed(l). 
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NAME 

sed - stream editor 
SYNOPSIS 

sed [ -n ] [ -e script ] [ -f sfile ] [ files ] 

DESCRIPTION 

Sed copies the named files (standard input default) to the standard output, edited according to a script of 
commands. The -f option causes the script to be taken from file sfile; these options accumulate. If there is 
just one -e option and no -f options, the flag -e may be omitted. The -n option suppresses the default out¬ 
put. A script consists of editing commands, one per line, of the following form: 

[ address [ , address ] ] function [ arguments ] 

In normal operation, sed cyclically copies a line of input into a pattern space (unless there is something left 
after a D command), applies in sequence all commands whose addresses select that pattern space, and at 
the end of the script copies the pattern space to the standard output (except under -n) and deletes the pattern 
space. 

Some of the commands use a hold space to save all or part of the pattern space for subsequent retrieval. 

An address is either a decimal number that counts input lines cumulatively across files, a $ that addresses 
the last line of input, or a context address, i.e., z. I regular expression/ in the style of ed{l) modified thus: 

In a context address, the construction \?regular expression?, where ? is any character, is identical 
to /regular expression/. Note that in the context address \xabc\xdefx, the second x stands 
for itself, so that the regular expression is abcxdef. 

The escape sequence \n matches a new-line embedded in the pattern space. 

A period. matches any character except the terminal new-line of the pattern space. 

A command line with no addresses selects every pattern space. 

A command line with one address selects each pattern space that matches the address. 

A command line with two addresses selects the inclusive range from the first pattern space that 
matches the first address through the next pattern space that matches the second. (If the 
second address is a number less than or equal to the line number first selected, only one 
line is selected.) Thereafter the process is repeated, looking again for the first address. 

Editing commands can be applied only to non-selected pattern spaces by use of the negation function ! 
(below). 

In the following list of functions the maximum number of permissible addresses for each function is indi¬ 
cated in parentheses. 

The text argument consists of one or more lines, all but the last of which end with \ to hide the new-line. 
Backslashes in text are treated like backslashes in the replacement string of an s command, and may be 
used to protect initial blanks and tabs against the stripping that is done on every script line. The rfile or 
wfile argument must terminate the command line and must be preceded by exactly one blank. Each wfile is 
created before processing begins. There can be at most 10 distinct wfile arguments. 

(1) a\ 

text Append. Place text on the output before reading the next input line. 

(2) b label Branch to the : command bearing the label. If label is empty, branch to the end of the script. 
(2)c\ 

text Change. Delete the pattern space. With 0 or 1 address or at the end of a 2-address range, place 

text on the output. Start the next cycle. 

(2) d Delete the pattern space. Start the next cycle. 

(2) D Delete the initial segment of the pattern space through the first new-line. Start the next cycle. 

(2) g Replace the contents of the pattern space by the contents of the hold space. 

(2) G Append the contents of the hold space to the pattern space. 

(2) h Replace the contents of the hold space by the contents of the pattern space. 
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(2) H Append the contents of the pattern space to the hold space. 

(1) i\ 

text Insert. Place text on the standard output. 

(2) 1 List the pattern space on the standard output in an unambiguous form. Non-printing characters 

are spelled in two-digit ASCII and long lines are folded. 

(2) n Copy the pattern space to the standard output. Replace the pattern space with the next line of 

input. 

(2) N Append the next line of input to the pattern space with an embedded new-line. (The current 
line number changes.) 

(2) p Print. Copy the pattern space to the standard output. 

(2) P Copy the initial segment of the pattern space through the first new-line to the standard output. 

(1) q Quit. Branch to the end of the script. Do not start a new cycle. 

(2) r rfile Read the contents of rfile. Place them on the output before reading the next input line. 

(2) siregular expressionireplacementiflags 

Substitute the replacement string for instances of the regular expression in the pattern space. 
Any character may be used instead of /. For a fuller description see ed(].). Flags is zero or 
more of: 

g Global. Substitute for all nonoverlapping instances of the regular expression 

rather than just the first one. 

p Print the pattern space if a replacement was made, 

w wfile Write. Append the pattern space to wfile if a replacement was made. 

Test. Branch to the : command bearing the label if any substitutions have been made since the 
most recent reading of an input line or execution of a t. If label is empty, branch to the end of 
the script. 

Write. Append the pattern space to wfile. 

Exchange the contents of the pattern and hold spaces. 

(2) yistringl Istringll 

Transform. Replace all occurrences of characters in stringl with the corresponding character 
in stringl. The lengths of stringl and stringl must be equal. 

{2)\ function 

Don’t. Apply function (or group, li function is {) only to lines not selected by the 
address(es). 

(0): label This command does nothing; it bears a label for b and t commands to branch to. 

(1) = Place the current line number on the standard output as a line. 

(2) { Execute the following commands through a matching } only when the pattern space is selected. 

(0) An empty command is ignored. 

SEE ALSO 

awk(l), ed(l), grep(l). 

SED-A Non-interactive Text Editor by L. E. McMahon. 


(2)t label 

(2) w wfile 
(2)x 
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NAME 

send, gath - gather files and/or submit RJE jobs 
SYNOPSIS 

gath [-ih] file... 
send argument... 

DESCRIPTION 

Gath 

Gath concatenates the named files and writes them to the standard output. Tabs are expanded into spaces 
according to the format specification for each file (seefspec(5)). The size limit and margin parameters of a 
format specification are also respected. Non-graphic characters other than tabs are identified by a diagnos¬ 
tic message and excised. The output of gath contains no tabs unless the -h flag is set, in which case the 
output is written with standard tabs (every eighth column). 

Any line of any of the files which begins with ^ is interpreted by gath as a control line. A line beginning 
” (tilde,space) specifies a sequence of files to be included at that point. A line beginning “! specifies a 
UNIX command; that command is executed, and its output replaces the “I line in the gath output. 

Setting the -i flag prevents control lines from being interpreted and causes them to be output literally. 

A file name of - at any point refers to standard input, and a control line consisting of is a logical EOF. 
Keywords may be defined by specifying a replacement string which is to be substituted for each occurrence 
of the keyword. Input may be collected directly from the terminal, with several alternatives for prompting. 
In fact, all of the special arguments and flags recognized by the send command are also recognized and 
treated identically by gath. Several of them only make sense in the context of submitting an RJE job. 

Send 

Send is a command-level interface to the RJE subsystems. It allows the user to collect input from various 
sources in order to create a run stream consisting of card images, and submit this run stream for transmis¬ 
sion to a host computer. 

Possible sources of input to send are: ordinary files, standard input, the terminal, and the output of a com¬ 
mand or shell file. Each source of input is treated as a virtual file, and no distinction is made based upon its 
origin. Typical input is an ASCII text file of the sort that is created by the editor ed{\). An optional format 
specification appearing in the first line of a file {s,tt fspec{5)) determines the settings according to which 
tabs are expanded into spaces. In addition, lines that begin with “ are normally interpreted as commands 
controlling the execution of send. They may be used to set or reset flags, to define keyword substitutions, 
and to open new sources of input in the midst of the current source. Other text lines are translated one-for- 
one into card images of the run stream. 

The run stream that results from this collection is treated as one job by the RJE subsystems. Send prints the 
card count of the run stream, and the queuer that is invoked prints the name of the temporary file that holds 
the job while it is awaiting transmission. The initial card of a job submitted to an IBM host must have a // 
in the first column. The initial card of a job submitted to a UNIVAC host must begin with a “@RUN” or 
“^run”, etc. Any cards preceding these will be excised. If a host computer is not specified before the first 
card of the runstream is ready to be sent, send will select a reasonable default. In the case of an IBM job, all 
cards beginning with /*$ will be excised from the runstream, because they are HASP command cards. 

The arguments that send accepts are described below. An argument is interpreted according to the first pat¬ 
tern that it matches. Preceding a character with \ causes it to loose any special meaning it might otherwise 
have when matching against an argument pattern. 

Close the current source. 

- Open standard input as a new source. 

+ Open the terminal as a new source. 

Establish a default format specification for included sources, 
e.g., :m6t-12: 


'.spec'. 
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‘.message 

—'.prompt 

+:prompt 

-flags 

+flags 

=flags 

Icommand 


Print message on the terminal. 

Open standard input and, if it is a terminal, print prompt. 

Open the terminal and print prompt. 

Set the specified flags, which are described below. 

Reset the specified flags. 

Restore the specified flags to their state at the previous level. 

Execute the specified UNIX command via the one-line shell, with input redi¬ 
rected to /dev/null as a default. Open the standard output of the command as a 
new source. 


%line 


@ directory 

"comment 

^'.keyword 

2keyword=xx 

2keyword=string 

^'.keyword 
keyword=xx 
keyword—string 
host 


file-name 


Collect contiguous arguments of this form and write them as consecutive lines 
to a temporary file; then have the file executed by the shell. Open the standard 
output of the shell as a new source. 

The current directory for the send process is changed to directory. The origi¬ 
nal directory will be restored at the end of the current source. 

Ignore this argument. 

Prompt for a definition of keyword from the terminal unless keyword has an 
existing definition. 

Define the keyword as a two digit hexadecimal character code unless it already 
has a non null replacement. 

Define the keyword in terms of a replacement string unless it already has a non 
null replacement. 

Prompt for a definition of keyword from the terminal. 

Define keyword as a two-digit hexadecimal character code. 

Define keyword in terms of a replacement string. 

The host machine that the job should be submitted to. It can be any name that 
corresponds to one in the first column of the RJE configuration file 

(/usr/rje/lines). 

Open the specified file as a new source of input. 


When commands are executed via $ or ! the shell environment (see environ(7)) will contain the values of 
all send keywords that begin with $ and have the syntax of a shell variable. 


The flags recognized by send are described in terms of the special processing that occurs when they are 
set: 


-1 List card images on standard output. EBCDIC characters are translated back to ASCII. 

-q Do not output card images. 

-f Do not fold lower case to upper. 

-t Trace progress on diagnostic output, by announcing the opening of input sources. 

-k Ignore the keywords that are active at the previous level and erase any keyword definitions that 

have been made at the current level. 

-r Process included sources in raw mode; pack arbitrary 8-bit bytes one per column (80 columns 
per card) until an EOE. 

-i Do not interpret control lines in included sources; treat them as text. 

-s Make keyword substitutions before detecting and interpreting control lines. 
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-y Suppress error diagnostics and submit job anyway. 

-g Gather mode, qualifying -1 flag; list text lines before converting them to card images. 

-h Write listing with standard tabs. 

-p Prompt with * when taking input from the terminal. 

-m When input returns to the terminal from a lower level, repeat the prompt, if any. 

-a Make -k flag propagate to included sources, thereby protecting them from keyword substitu¬ 
tions. 

-c List control lines on diagnostic output. 

-d Extend the current set of keyword definitions by adding those active at the end of included 
sources. 

-X This flag guarantees that the job will be transmitted in the order of submission (relative to other 
jobs sent with this flag). 

Control lines are input lines that begin with In the default mode +ir, they are interpreted as com¬ 
mands to send. Normally they are detected immediately and read literally. The -s flag forces key¬ 
word substitutions to be made before control lines are intercepted and interpreted. This can lead to 
unexpected results if a control line uses a keyword which is defined within an immediately preceding 
“$ sequence. Arguments appearing in control lines are handled exactly like the command arguments to 
send, except that they are processed at a nested level of input. 

The two possible formats for a control line are: “"argument” and argumentIn the first case, 
where the " is not followed by a space, the remainder of the line is taken as a single argument to send. 
In the second case, the line is parsed to obtain a sequence of arguments delimited by spaces. In this 
case the quotes ' and " may be employed to pass embedded spaces. 

The interpretation of the argument . is chosen so that an input line consisting of", is treated as a logi¬ 
cal EOF. The following example illustrates some of the above conventions: 

send - 
argument... 

This sequence of three lines is equivalent to the command synopsis at the beginning of this descrip¬ 
tion. In fact, the - is not even required. By convention, the send command reads standard input if no 
other input source is specified. Send may therefore be employed as a filter with side-effects. 

The execution of the send command is controlled at each instant by a current environment, which 
includes the format specification for the input source, a default format specification for included 
sources, the settings of the mode flags, and the active set of keyword definitions. This environment 
can be altered dynamically. When a control line opens a new source of input, the current environment 
is pushed onto a stack, to be restored when input resumes from the old source. The initial format 
specification for the new source is taken from the first line of the file. If none is provided, the estab¬ 
lished default is used or, in its absence, standard tabs. The initial mode settings and active keywords 
are copied from the old environment. Changes made while processing the new source will not affect 
the environment of the old source, with one exception: if -d mode is set in the old environment, the 
old keyword context will be augmented by those definitions that are active at the end of the new 
source. 

When send first begins execution, all mode flags are reset, and the values of the shell environment 
variables become the initial values for keywords of the same name with a $ prefixed. 

The initial reset state for all mode flags is the + state. In general, special processing associated with a 
mode N is invoked by flag -N and is revoked by flag +N. Most mode settings have an immediate 
effect on the processing of the current source. Exceptions to this are the -r and -i flags, which apply 
only to included source, causing it to be processed in an uninterpreted manner. 
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A keyword is an arbitrary 8-bit ASCII string for which a replacement has been defined. The replace¬ 
ment may be another string, or (for IBM RJE only) the hexadecimal code for a single 8-bit byte. At any 
instant, a given set of keyword definitions is active. Input text lines are scanned, in one pass from left 
to right, and longest matches are attempted between substrings of the line and the active set of key¬ 
words. Characters that do not match are output, subject to folding and the standard translation. Key¬ 
words are replaced by the specified hexadecimal code or replacement string, which is then output char¬ 
acter by character. The expansion of tabs and length checking, according to the format specification of 
an input source, are delayed until substitutions have been made in a line. 

All of the keywords definitions made in the current source may be deleted by setting the -k flag. It 
then becomes possible to reuse them. Setting the -k flag also causes keyword definitions active at the 
previous source level to be ignored. Setting the +k flag causes keywords at the previous level to be 
ignored but does not delete the definitions made at the current level. The =k argument reactivates the 
definitions of the previous level. 

When keywords are redefined, the previous definition at the same level of source input is lost, however 
the definition at the previous level is only hidden, to be reactivated upon return to that level unless a 
-d flag causes the current definition to be retained. 

Conditional prompts for keywords, ?:A,/p which have already been defined at some higher level to be 
null or have a replacement will simply cause the definitions to be copied down to the current level; 
new definitions will not be solicited. 

Keyword substitution is an elementary macro facility that is easily explained and that appears useful 
enough to warrant its inclusion in the send command. More complex replacements are the function of 
a general macro processor (m4(l), perhaps). To reduce the overhead of string comparison, it is recom¬ 
mended that keywords be chosen so that their initial characters are unusual. For example, let them all 
be upper case. 

Send performs two types of error checking on input text lines. Firstly, only ASCII graphics and tabs 
are permitted in input text. Secondly, the length of a text line, after substitutions have been made, may 
not exceed 80 bytes for IBM, or 132 bytes for UNIVAC. The length of each line may be additionally 
constrained by a size parameter in the format specification for an input source. Diagnostic output pro¬ 
vides the location of each erroneous line, by line number and input source, a description of the error, 
and the card image that results. Other routine errors that are announced are the inability to open or 
write files, and abnormal exits from the shell. Normally, the occurrence of any error causes send, 
before invoking the queuer, to prompt for positive affirmation that the suspect run stream should be 
submitted. 

For IBM hosts, send is required to translate 8-bit ASCII characters into their EBCDIC equivalents. The 
conversion for 8-bit ASCII characters in the octal range 040-176 is based on the character set described 
in “Appendix H” of IBM System/370 Principles of Operation (IBM SRL GA22-7000). Each 8-bit 
ASCII character in the range 040-377 possesses an EBCDIC equivalent into which it is mapped, with 
five exceptions: " into —i, 0345 into 0325 into 0, 0313 into I , 0177 (DEL) is illegal. In listings 
requested from send and in printed output returned by the subsystem, the reverse translation is made 
with the qualification that EBCDIC characters that do not have valid 8-bit ASCII equivalents are trans¬ 
lated into UNIVAC hosts, on the other hand, operate in ASCII code, and any translations between 
ASCII and field-data are made, in accordance with the UNIVAC standard, by the host computer. 

Additional control over the translation process is afforded by the -f flag and hexadecimal character 
codes. As a default, send folds lower-case letters into upper case. For UNIVAC RJE it does more: the 
entire ASCII range 0140-0176 is folded into 0100-0136, so that for example, becomes In either 
case, setting the -f flag inhibits any folding. Non-standard character codes are obtained as a special 
case of keyword substitution. 

SEE ALSO 

m4(l), orjestat(lC), rjestat(lC), sh(l), fspec(5), ascii(7), hasp(8), rje(8), uvac(8). 

Guide to IBM Remote Job Entry for PWB/UNIX Users by A. L. Sabsevitz and E. J. Finger. 
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UNIX Remote Job Entry User’s Guide by K. A. Kelleman. 

BUGS 

Standard input is read in blocks, and unused bytes are returned via lseek{2). If standard input is a pipe, 
multiple arguments of the form - and -.prompt should not be used, nor should the logical EOF 
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NAME 

setmnt - establish mnttab table 

SYNOPSIS 

/etc/setmnt 

DESCRIPTION 

Setmnt creates the /etc/mnttab table (see mnttab{5)), which is needed for both the mount{\yi) and 
umount{\M) commands. Setmnt reads standard input and creates a mnttab entry for each line. Input lines 
have the format: 

filesys node 

where filesys is the name of the file system’s special file (e.g., “rp??”) and node is the root name of that 
file system. Thus filesys and node become the first two strings in the mnttab(5) entry. 

FILES 

/etc/mnttab 

SEE ALSO 

mnttab(5). 

BUGS 

Evil things will happen if filesys or node are longer than 10 characters. 

Setmnt silently enforces an upper limit on the maximum number of mnttab entries. 
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NAME 

sh - shell, the standard command programming language 
SYNOPSIS 

sh [ -ceiknrstuvx ] [ args ] 

DESCRIPTION 

Sh is a command programming language that executes commands read from a terminal or a file. See 
Invocation below for the meaning of arguments to the shell. 

Commands. 

A simple-command is a sequence of non-blank words separated by blanks (a blank is a tab or a space). 
The first word specifies the name of the command to be executed. Except as specified below, the remaining 
words are passed as arguments to the invoked command. The command name is passed as argument 0 (see 
exec{2)). The value of a simple-command is its exit status if it terminates normally, or (octal) 200+status if 
it terminates abnormally (see signal(2) for a list of status values). 

A pipeline is a sequence of one or more commands separated by I . The standard output of each command 
but the last is connected by a pipe{2) to the standard input of the next command. Each command is run as a 
separate process; the shell waits for the last command to terminate. 

A list is a sequence of one or more pipelines separated by ;, &, &&, or I I , and optionally terminated by ; 
or &. Of these four symbols, ; and & have equal precedence, which is lower than that of && and I I. The 
symbols && and I I also have equal precedence. A semicolon (;) causes sequential execution of the pre¬ 
ceding pipeline; an ampersand (&) causes asynchronous execution of the preceding pipeline (i.e., the shell 
does not wait for that pipeline to finish). The symbol && (II) causes the list following it to be executed 
only if the preceding pipeline returns a zero (non-zero) exit status. An arbitrary number of new-lines may 
appear in a list, instead of semicolons, to delimit commands. 

A command is either a simple-command or one of the following. Unless otherwise stated, the value 
returned by a command is that of the last simple-command executed in the command. 

for name [ in word ... ] do list done 

Each time a for command is executed, name is set to the next word taken from the in word list. If 
in word ... is omitted, then the for command executes the do list once for each positional param¬ 
eter that is set (see Parameter Substitution below). Execution ends when there are no more words 
in the list. 

case word in [ pattern [ I pattern ] ...) list ;; ] ... esac 

A case command executes the list associated with the first pattern that matches word. The form 
of the patterns is the same as that used for file-name generation (see File Name Generation 
below). 

if list then list [ elif list then list ]... [ else list ] ft 

The list following if is executed and, if it returns a zero exit status, the list following the first then 
is executed. Otherwise, the list following elif is executed and, if its value is zero, the list follow¬ 
ing the next then is executed. Failing that, the else list is executed. If no else list or then list is 
executed, then the if command returns a zero exit status, 
while list do list done 

A while command repeatedly executes the while list and, if the exit status of the last command in 
the list is zero, executes the do list; otherwise the loop terminates. If no commands in the do list 
are executed, then the while command returns a zero exit status; until may be used in place of 
while to negate the loop termination test. 

(list) 

Execute list in a sub-shell. 

{list;} 

list is simply executed. 

The following words are only recognized as the first word of a command and when not quoted: 
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if then else elif fi case esac for while until do done { } 

Comments. 

A word beginning with # causes that word and all the following characters up to a new-line to be ignored. 
Command Substitution. 

The standard output from a command enclosed in a pair of grave accents (' ' ) may be used as part or all of 
a word; trailing new-lines are removed. 

Parameter Substitution. 

The character $ is used to introduce substitutable parameters. Positional parameters may be assigned val¬ 
ues by set. Variables may be set by writing: 

name=value [ name=value ] ... 

Pattern-matching is not performed on value. 

%{parameter} 

A parameter is a sequence of letters, digits, or underscores (a name), a digit, or any of the charac¬ 
ters *, @, #, ?, $, and !. The value, if any, of the parameter is substituted. The braces are 

required only when parameter is followed by a letter, digit, or underscore that is not to be inter¬ 
preted as part of its name. A name must begin with a letter or underscore. If parameter is a digit 
then it is a positional parameter. If parameter is * or @, then all the positional parameters, start¬ 
ing with $1, are substituted (separated by spaces). Parameter $0 is set from argument zero when 
the shell is invoked. 

%{parameteri—word} 

If parameter is set and is non-null then substitute its value; otherwise substitute word. 
%{parameter'.=word} 

If parameter is not set or is null then set it to word ; the value of the parameter is then substituted. 
Positional parameters may not be assigned to in this way. 

${parameter:?word} 

If parameter is set and is non-null then substitute its value; otherwise, print word and exit from 
the shell. If word is omitted, then the message “parameter null or not set” is printed. 
%{parameteri-¥word} 

If parameter is set and is non-null then substitute word; otherwise substitute nothing. 

In the above, word is not evaluated unless it is to be used as the substituted string, so that, in the following 
example, pwd is executed only if d is not set or is null: 

echo ${d:-'- pwd^ } 

If the colon (:) is omitted from the above expressions, then the shell only checks whether parameter is set 
or not. 

The following parameters are automatically set by the shell: 

# The number of positional parameters in decimal. 

- Flags supplied to the shell on invocation or by the set command. 

? The decimal value returned by the last synchronously executed command. 

$ The process number of this shell. 

! The process number of the last background command invoked. 

The following parameters are used by the shell: 

HOME The default argument (home directory) for the cd command. 

PATH The search path for commands (see Execution below). 

MAIL If this variable is set to the name of a mail file, then the shell informs the user of the 
arrival of mail in the specified file. 

PSl Primary prompt string, by default “$ 

PS2 Secondary prompt string, by default “> 

IFS Internal field separators, normally space, tab, and new-line. 
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The shell gives default values to PATH, PSl, PS2, and IFS, while HOME and MAIL are not set at all by the 
shell (although HOME is set by login(\)). 

Blank Interpretation. 

After parameter and command substitution, the results of substitution are scanned for internal field separa¬ 
tor characters (those found in IFS) and split into distinct arguments where such characters are found. 
Explicit null arguments (""or ' ') are retained. Implicit null arguments (those resulting from parameters 
that have no values) are removed. 

File Name Generation. 

Following substitution, each command word is scanned for the characters *, ?, and [. If one of these char¬ 
acters appears then the word is regarded as a pattern. The word is replaced with alphabetically sorted file 
names that match the pattern. If no file name is found that matches the pattern, then the word is left 
unchanged. The character . at the start of a file name or immediately following a /, as well as the character / 
itself, must be matched explicitly. 

* Matches any string, including the null string. 

? Matches any single character. 

[... ] Matches any one of the enclosed characters. A pair of characters separated by - matches 
any character lexically between the pair, inclusive. 

Quoting. 

The following characters have a special meaning to the shell and cause termination of a word unless 
quoted: 

; & ( ) I < > new-line space tab 

A character may be quoted (i.e., made to stand for itself) by preceding it with a \. The pair \new-line is 
ignored. All characters enclosed between a pair of single quote marks except a single quote, are 

quoted. Inside double quote marks (" "), parameter and command substitution occurs and \ quotes the char¬ 
acters and $. "$*" is equivalent to "$1 $2 whereas "$@" is equivalent to "$1" "$2"_ 

Prompting. 

When used interactively, the shell prompts with the value of PSl before reading a command. If at any time 
a new-line is typed and further input is needed to complete a command, then the secondary prompt (i.e., the 
value of PSl) is issued. 


Input/Output. 

Before a command is executed, its input and output may be redirected using a special notation interpreted 
by the shell. The following may appear anywhere in a simple-command or may precede or follow a 
command and are not passed on to the invoked command; substitution occurs before word or digit is used: 


<word 

>word 

»word 

<gc[-]word 


<&digit 


<&- 


Use file word as standard input (file descriptor 0). 

Use file word as standard output (file descriptor 1). If the file does not exist then it is cre¬ 
ated; otherwise, it is truncated to zero length. 

Use file word as standard output. If the file exists then output is appended to it (by first 
seeking to the end-of-file); otherwise, the file is created. 

The shell input is read up to a line that is the same as word, or to an end-of-file. The 
resulting document becomes the standard input. If any character of word is quoted, then 
no interpretation is placed upon the characters of the document; otherwise, parameter and 
command substitution occurs, (unescaped) \new-Iine is ignored, and \ must be used to 
quote the characters \, $, ', and the first character of word. If - is appended to <, then all 
leading tabs are stripped from word and from the document. 

The standard input is duplicated from file descriptor digit (see dup(2)). Similarly for the 
standard output using >. 

The standard input is closed. Similarly for the standard output using >. 


If one of the above is preceded by a digit, then the file descriptor created is that specified by the digit 
(instead of the default 0 or 1). For example: 
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... 2>&1 

creates file descriptor 2 that is a duplicate of file descriptor 1. 

If a command is followed by & then the default standard input for the command is the empty file /dev/null. 
Otherwise, the environment for the execution of a command contains the file descriptors of the invoking 
shell as modified by input/output specifications. 

Environment. 

The environment (see environ{iy) is a list of name-value pairs that is passed to an executed program in the 
same way as a normal argument list. The shell interacts with the environment in several ways. On invoca¬ 
tion, the shell scans the environment and creates a parameter for each name found, giving it the correspond¬ 
ing value. Executed commands inherit the same environment. If the user modifies the values of these 
parameters or creates new ones, none of these affects the environment unless the export command is used 
to bind the shell’s parameter to the environment. The environment seen by any executed command is thus 
composed of any unmodified name-value pairs originally inherited by the shell, plus any modifications or 
additions, all of which must be noted in export commands. 

The environment for any simple-command may be augmented by prefixing it with one or more assignments 
to parameters. Thus: 

TERM=450 cmd args and 

(export TERM; TERM=450; cmd args) 

are equivalent (as far as the above execution of cmd is concerned). 

If the -k flag is set, all keyword arguments are placed in the environment, even if they occur after the com¬ 
mand name. The following first prints a=b c and then c: 

echo a=b c 
set -k 
echo a=b c 

Signals. 

The INTERRUPT and QUIT signals for an invoked command are ignored if the command is followed by &; 
otherwise signals have the values inherited by the shell from its parent, with the exception of signal 11 (but 
see also the trap command below). 

Execution. 

Each time a command is executed, the above substitutions are carried out. Except for the Special 
Commands listed below, a new process is created and an attempt is made to execute the command via 
exec{2). 

The shell parameter PATH defines the search path for the directory containing the command. Alternative 
directory names are separated by a colon (:). The default path is :/bin:/usr/bin (specifying the current 
directory, /bin, and /usr/bin, in that order). Note that the current directory is specified by a null path name, 
which can appear immediately after the equal sign or between the colon delimiters anywhere else in the 
path list. If the command name contains a / then the search path is not used. Otherwise, each directory in 
the path is searched for an executable file. If the file has execute permission but is not an a.out file, it is 
assumed to be a file containing shell commands. A sub-shell (i.e., a separate process) is spawned to read it. 
A parenthesized command is also executed in a sub-shell. 

Special Commands. 

The following commands are executed in the shell process and, except as specified, no input/output redirec¬ 
tion is permitted for such commands: 

: No effect; the command does nothing. A zero exit code is returned. 

. file Read and execute commands iromfile and return. The search path specified by PATH is used to 

find the directory containing . 
break [ n ] 

Exit from the enclosing for or while loop, if any. If n is specified then break n levels. 
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continue [ n ] 

Resume the next iteration of the enclosing for or while loop. If n is specified then resume at the 
«-th enclosing loop, 
cd [ arg ] 

Change the current directory to arg. The shell parameter HOME is the default arg. 
eval [ arg ... ] 

The arguments are read as input to the shell and the resulting command(s) executed, 
exec [ arg ... ] 

The command specified by the arguments is executed in place of this shell without creating a new 
process. Input/output arguments may appear and, if no other arguments are given, cause the shell 
input/output to be modified, 
exit [ n ] 

Causes a shell to exit with the exit status specified by n. If « is omitted then the exit status is that 
of the last command executed (an end-of-file will also cause the shell to exit.) 
export [ name ... ] 

The given names are marked for automatic export to the environment of subsequently-executed 
commands. If no arguments are given, then a list of all names that are exported in this shell is 
printed. 

newgrp [ arg ... ] 

Equivalent to exec newgrp arg .... 
read [ name ... ] 

One line is read from the standard input and the first word is assigned to the first name, the second 
word to the second name, etc., with leftover words assigned to the last name. The return code is 0 
unless an end-of-file is encountered, 
readonly [ name ... ] 

The given names are marked readonly and the values of the these names may not be changed by 
subsequent assignment. If no arguments are given, then a list of all readonly names is printed, 
set [ -ekntuvx [ arg ... ] ] 

-e If the shell is non-interactive then exit immediately if a command exits with a non-zero 
exit status. 

-k All keyword arguments are placed in the environment for a command, not just those that 
precede the command name. 

-n Read commands but do not execute them. 

-t Exit after reading and executing one command. 

-u Treat unset variables as an error when substituting. 

-V Print shell input lines as they are read. 

-X Print commands and their arguments as they are executed. 

— Do not change any of the flags; useful in setting $1 to -. 

Using + rather than - causes these flags to be turned off. These flags can also be used upon invo¬ 
cation of the shell. The current set of flags may be found in $-. The remaining arguments are 
positional parameters and are assigned, in order, to $1, $2, .... If no arguments are given then the 
values of all names are printed. 

shift 

The positional parameters from $2 ... are renamed $1_ 

test 

Evaluate conditional expressions. See test(\) for usage and description. 

times 

Print the accumulated user and system times for processes run from the shell, 
trap [arg ][n ]... 

arg is a command to be read and executed when the shell receives signal(s) n. (Note that arg is 
scanned once when the trap is set and once when the trap is taken.) Trap commands are executed 
in order of signal number. Any attempt to set a trap on a signal that was ignored on entry to the 
current shell is ineffective. An attempt to trap on signal 11 (memory fault) produces an error. If 
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arg is absent then all trap(s) n are reset to their original values. If arg is the null string then this 
signal is ignored by the shell and by the commands it invokes. If n is 0 then the command arg is 
executed on exit from the shell. The trap command with no arguments prints a list of commands 
associated with each signal number, 
umask [ nnn ] 

The user file-creation mask is set to nnn (see umask(2)). If nnn is omitted, the current value of the 
mask is printed. 

wait Wait for all child processes to terminate report the termination status. If n is not given then all 
currently active child processes are waited for. The return code from this command is always 
zero. 

Invocation. 

If the shell is invoked through exec{2) and the first character of argument zero is commands are initially 
read from /etc/profile and then from $HOME/.profile, if such files exist. Thereafter, commands are read as 
described below, which is also the case when the shell is invoked as /bin/sh. The flags below are inter¬ 
preted by the shell on invocation only; Note that unless the -c or -s flag is specified, the first argument is 
assumed to be the name of a file containing commands, and the remaining arguments are passed as posi¬ 
tional parameters to that command file: 

-c string If the -c flag is present then commands are read from string. 

-s If the -s flag is present or if no arguments remain then commands are read from the standard 

input. Any remaining arguments specify the positional parameters. Shell output is written to 
file descriptor 2. 

-i If the -i flag is present or if the shell input and output are attached to a terminal, then this shell 

is interactive. In this case TERMINATE is ignored (so that kill 0 does not kill an interactive 
shell) and INTERRUPT is caught and ignored (so that wait is interruptible). In all cases, QUIT 
is ignored by the shell. 

-r If the -r flag is present the shell is a restricted shell (see rsh(l)). 

The remaining flags and arguments are described under the set command above. 

EXIT STATUS 

Errors detected by the shell, such as syntax errors, cause the shell to return a non-zero exit status. If the 
shell is being used non-interactively then execution of the shell file is abandoned. Otherwise, the shell 
returns the exit status of the last command executed (see also the exit command above). 

FILES 

/etc/profile 

$HOME/.profile 

/tmp/sh* 

/dev/null 

SEE ALSO 

cd(l), env(l), login(l), newgrp(l), rsh(l), test(l), umask(l), dup(2), exec(2), fork(2), pipe(2), signal(2), 
umask(2), wait(2), a.out(5), profile(5), environ(7). 

BUGS 

The command readonly (without arguments) produces the same output as the command export. 

If < is used to provide standard input to an asynchronous process invoked by &, the shell gets mixed up 
about naming the input document; a garbage file /tmp/sh* is created and the shell complains about not 
being able to And that file by another name. 
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NAME 

shutdown - terminate all processing 

SYNOPSIS 

/etc/shutdown 

DESCRIPTION 

Shutdown is part of the UNIX operation procedures. Its primary function is to terminate all currently run¬ 
ning processes in an orderly and cautious manner. The procedure is designed to interact with the operator 
(i.e., the person who invoked shutdown). Shutdown may instruct the operator to perform some specific 
tasks, or to supply certain responses before execution can resume. Shutdown goes through the following 
steps: 

All users logged on the system are notified to log off the system by a broadcasted message. The opera¬ 
tor may display his/her own message at this time. Otherwise, the standard file save message is dis¬ 
played. 

If the operator wishes to run the file-save procedure, shutdown unmounts all file systems. 

All file systems’ super blocks are updated before the system is to be stopped (see ^y«c(lM)). This must 
be done before re-booting the system, to insure file system integrity. The most common error diagnos¬ 
tic that will occur is device busy. This diagnostic happens when a particular file system could not be 
unmounted. S,etumount{\M). 

SEE ALSO 

sync(lM), umount(lM). 
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NAME 

size - size of an object file 

SYNOPSIS 

size [ object... ] 

DESCRIPTION 

Size prints the (decimal) number of bytes required by the text, data, and bss portions, and their sum in octal 
and decimal, of each object-file argument. If no file is specified, a.out is used. 

SEE ALSO 

a.out(5). 
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NAME 

sleep - suspend execution for an interval 

SYNOPSIS 

sleep time 

DESCRIPTION 

Sleep suspends execution for time seconds. It is used to execute a command after a certain amount of time 
as in: 

(sleep 105; command)& 
or to execute a command every so often, as in: 

while true 
do 

command 
sleep 37 

done 

SEE ALSO 

alarm(2), sleep(3C). 

BUGS 

Time must be less than 65536 seconds. 
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NAME 

sno - SNOBOL interpreter 

SYNOPSIS 

sno [ files ] 

DESCRIPTION 

Sno is a SNOBOL compiler and interpreter (with slight differences). Sno obtains input from the concatena¬ 
tion of the named files and the standard input. All input through a statement containing the label end is 
considered program and is compiled. The rest is available to syspit. 

Sno differs from SNOBOL in the following ways; 

There are no unanchored searches. To get the same effect: 

a ** b unanchored search for Z?. 

a *x* b = X c unanchored assignment 

There is no back referencing. 

X = "abc" 

a *x* X is an unanchored search for abc. 

Function declaration is done at compile time by the use of the (non-unique) label define. Execu¬ 
tion of a function call begins at the statement following the define. Functions cannot be defined at 
run time, and the use of the name define is preempted. There is no provision for automatic vari¬ 
ables other than parameters. Examples: 

define f() 
define f(a, b, c) 

All labels except define (even end) must have a non-empty statement. 

Labels, functions and variables must all have distinct names. In particular, the non-empty state¬ 
ment on end cannot merely name a label. 

If start is a label in the program, program execution will start there. If not, execution begins with 
the first executable statement; define is not an executable statement. 

There are no builtin functions. 

Parentheses for arithmetic are not needed. Normal precedence applies. Because of this, the arith¬ 
metic operators / and * must be set off by spaces. 

The right side of assignments must be non-empty. 

Either' or " may be used for literal quotes. 

The pseudo-variable sysppt is not available. 

SEE ALSO 

awk(l). 

“SNOBOL, a String Manipulation Language,” by D. J. Farber, R. E. Griswold, and I. P. Polonsky, JACM 
11 (1964), pp. 21-30. 
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NAME 

sort - sort and/or merge files 
SYNOPSIS 

sort [ -cmubdfinrtx ] [ +posl [ -pos2 ]]...[ -o output ] [ names ] 

DESCRIPTION 

Sort sorts lines of all the named files together and writes the result on the standard output. The name - 
means the standard input. If no input files are named, the standard input is sorted. 

The default sort key is an entire line. Default ordering is lexicographic by bytes in machine collating 
sequence. The ordering is affected globally by the following options, one or more of which may appear. 

b Ignore leading blanks (spaces and tabs) in field comparisons, 
d ‘ ‘Dictionary” order: only letters, digits and blanks are significant in comparisons, 
f Fold upper case letters onto lower case. 

i Ignore characters outside the ASCII range 040-0176 in non-numeric comparisons. 

n An initial numeric string, consisting of optional blanks, optional minus sign, and zero or more digits 
with optional decimal point, is sorted by arithmetic value. Option n implies option b. 

r Reverse the sense of comparisons. 
tx ‘‘Tab character” separating fields is x. 

The notation +posl -pos2 restricts a sort key to a field beginning at posl and ending just before pos2. 
Posl and pos2 each have the form m.n, optionally followed by one or more of the flags bdfinr, where m 
tells a number of fields to skip from the beginning of the line and n tells a number of characters to skip fur¬ 
ther. If any flags are present they override all the global ordering options for this key. If the b option is in 
effect n is counted from the first non-blank in the field; b is attached independently to pos2. A missing .n 
means .0; a missing -pos2 means the end of the line. Under the -tx option, fields are strings separated by 
x; otherwise fields are non-empty non-blank strings separated by blanks. 

When there are multiple sort keys, later keys are compared only after all earlier keys compare equal. Lines 
that otherwise compare equal are ordered with all bytes significant. 

These option arguments are also understood: 

c Check that the input file is sorted according to the ordering rules; give no output unless the file is out 
of sort. 

m Merge only, the input files are already sorted. 

u Suppress all but one in each set of equal lines. Ignored bytes and bytes outside keys do not partici¬ 
pate in this comparison. 

o The next argument is the name of an output file to use instead of the standard output. This file may 
be the same as one of the inputs. 

EXAMPLES 

Print in alphabetical order all the unique spellings in a list of words (capitalized words differ from uncapi¬ 
talized): 

sort -u -i-Of +0 list 

Print the password file {passwd{5)) sorted by user ID (the third colon-separated field): 
sort -t: -i-2n /etc/passwd 

Print the first instance of each month in an already sorted file of (month-day) entries (the options -um with 
just one input file make the choice of a unique representative from a set of equal lines predictable): 


sort -um +0 -1 dates 
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FILES 

/usr/tmp/stm??? 

SEE ALSO 

comm(l), jom(l), uniq(l). 

DIAGNOSTICS 

Comments and exits with non-zero status for various trouble conditions and for disorder discovered under 
option -c. 

BUGS 

Very long lines are silently truncated. 
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NAME 

spell, spellin, spellout - find spelling errors 
SYNOPSIS 

spell [ options ] [ files ] 

/usr/lib/spell/spellin [ list ] 
/usr/lib/spell/spellout [ -d ] list 


DESCRIPTION 

Spell collects words from the named files and looks them up in a spelling list. Words that neither occur 
among nor are derivable (by applying certain inflections, prefixes, and/or suffixes) from words in the spel¬ 
ling list are printed on the standard output. If no files are named, words are collected from the standard 
input. 

Spell ignores most trojf{\), thl{\), and eqn{\.) constructions. 

Under the -v option, all words not literally in the spelling list are printed, and plausible derivations from the 
words in the spelling list are indicated. 

Under the -b option, British spelling is checked. Besides preferring centre, colour, speciality, travelled, 
etc., this option insists upon -ise in words like standardise, Fowler and the OED to the contrary notwith¬ 
standing. 

Under the -x option, every plausible stem is printed with = for each word. 

The spelling list is based on many sources, and while more haphazard than an ordinary dictionary, is also 
more effective with respect to proper names and popular technical words. Coverage of the specialized 
vocabularies of biology, medicine, and chemistry is light. 

Pertinent auxiliary files may be specified by name arguments, indicated below with their default settings. 
Copies of all output are accumulated in the history file. The stop list filters out misspellings (e.g., 
thier=thy-y-i-ier) that would otherwise pass. 


Two routines help maintain the hash lists used by spell (both expect a list of words, one per line, from the 
standard input): spellin adds the words on the standard input to the preexisting list and places a new list on 
the standard output. If no list is specified, the new list is created from scratch. Spellout looks up each word 
read from the standard input, and prints on the standard output those that are missing from (or, with the -d 
option, present in) the hash list. 


FILES 

D_SPELL=/usr/lib/spell/hlist[ab] 

S_SPELL=/usr/lib/spell/hstop 

H_SPELL=/usr/lib/spell/spellhist 

/tmp/spell.$$ 

/usr/lib/spell/spellprog 


hashed spelling lists, American & British 

hashed stop list 

history file 

temporary 

program 


SEE ALSO 

deroff(l), eqn(l), sed(l), sort(l), tbl(l), tee(l), troff(l), typo(l). 


BUGS 

The spelling list’s coverage is uneven; new installations will probably wish to monitor the output for sev¬ 
eral months to gather local additions; typically, these are kept in a separate local dictionary that is added to 
the hashed list via spellin. 

British spelling was done by an American. 
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NAME 

spline - interpolate smooth curve 

SYNOPSIS 

spline [ options ] 

DESCRIPTION 

Spline takes pairs of numbers from the standard input as abscissas and ordinates of a function. It produces 
a similar set, which is approximately equally spaced and includes the input set, on the standard output. The 
cubic spline output (R. W. Hamming, Numerical Methods for Scientists and Engineers, 2nd ed., pp. 349ff) 
has two continuous derivatives, and sufficiently many points to look smooth when plotted, for example by 
graph{\G). 

The following options are recognized, each as a separate argument: 

-a Supply abscissas automatically (they are missing from the input); spacing is given by the next 
argument, or is assumed to be 1 if next argument is not a number. 

-k The constant k used in the boundary value computation: 

tdefine prime! ’sup down 20 ndefine prime! ’sup "’ y sub 0 prime! ky sub 1 
prime! , y sub n prime! '=' ky sub n-1 prime! 
is set by the next argument (default k = 0). 

-n Space output points so that approximately n intervals occur between the lower and upper x limits 
(defaults = 100). 

-p Make output periodic, i.e., match derivatives at ends. First and last input values should normally 
agree. 

-X Next 1 (or !) arguments are lower (and upper) limits. Normally, these limits are calculated from 
the data. Automatic abscissas start at lower limit (default 0). 

SEE ALSO 

graph(lG). 

DIAGNOSTICS 

When data is not strictly monotone in x, spline reproduces the input without interpolating extra points. 

BUGS 

A limit of 1,000 input points is enforced silently. 
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NAME 

split - split a file into pieces 
SYNOPSIS 

split [ -n ] [ file [ name ] ] 

DESCRIPTION 

Split reads file and writes it in «-line pieces (default 1000), as many as necessary, onto a set of output files. 
The name of the first output file is name with aa appended, and so on lexicographically. If no output name 
is given, x is default. 

If no input file is given, or if - is given in its stead, then the standard input file is used. 

SEE ALSO 

bfs(l), csplit(l). 
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NAME 

St - synchronous terminal control 

SYNOPSIS 

/etc/stload 

/etc/stcntrl [ on I off ] 

DESCRIPTION 

The stload command file is used to load the synchronous terminal prototype script, /etc/proto, into the des¬ 
ignated KMCl 1-B microprocessor, and start execution of the script. As supplied, stload uses /dev/kmcO; it 
may need local modification if another KMCl 1-B is being used. 

The stcntrl command is used to activate and deactivate the synchronous terminal driver. 

The /etc/rc file should contain the following multi-user entries: 

/etc/stload 
/etc/stcntrl on 

while /etc/shutdown should have: 

/etc/stcntrl off 


FILES 

/etc/stproto 

/dev/kmc? 

/dev/vpm? 

/dev/stO 

/dev/st? 


synchronous terminal prototype script 
KMCl 1-B microprocessor 
virtual protocol machine 
synchronous terminal control channel 
synchronous terminal user channels 


SEE ALSO 

kmc(4), st(4), trace(4), vpm(4). 


BUGS 

The stcntrl.c file assumes that /dev/vpmO is the vpm device being used for the first (and usually only) syn¬ 
chronous terminal controller. If some other vpm device is being used, the stcntrl.c file must be modified 
and rebuilt. 
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NAME 

stat - statistical network useful with graphical commands 
SYNOPSIS 

node-name [options] [files] 

DESCRIPTION 

Stat is a collection of command level functions (nodes) that can be interconnected using sh(].) to form a sta¬ 
tistical network. The nodes reside in /usr/bin/graf (see graphics(IG)). Data is passed through the network 
as sequences of numbers (vectors), where a number is of the form: 

[sign](digits)(.digits)[e[sign]digits] 

evaluated in the usual way. Brackets and parentheses surround fields. All fields are optional, but at least 
one of the fields surrounded by parentheses must be present. Any character input to a node that is not part 
of a number is taken as a delimiter. 

Stat nodes are divided into four classes. 

Transformers, which map input vector elements into output vector elements; 

Summarizers, which calculate statistics of a vector; 

Translators, which convert among formats; and 

Generators, which are sources of definable vectors. 

Below is a list of synopses for stat nodes. Most nodes accept options indicated by a leading minus (-). In 
general, an option is specified by a character followed by a value, such as c5. This is interpreted as c := 5 (c 
is assigned 5). The following keys are used to designate the expected type of the value: 

c characters, 

/ integer, 

/ floating point or integer, 

file file name, and 

string string of characters, surrounded by quotes to include a Shell argument delimiter. 

Options without keys are flags. All nodes except generators accept files as input, hence it is not indicated 
in the synopses. 

Transformers: 

abs [ -c/ ] - absolute value 

columns (similarly for -c options that follow) 

af [ -c/ tv]- arithmetic function 

titled output, verbose 

ceil [ -c/ ] - round up to next integer 

cusum [ -c/ ] - cumulative sum 
exp [ -c/ ] - exponential 

floor [ -c/ ] - round down to next integer 

gamma [ -c/ ] - gamma 

list [ -c/ dstring ] - list vector elements 

delimiter(s) 

log [ -c/ b/ ] - logarithm 

base 


mod 


[ -c/ m/ ] - modulus 
modulus 
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pair 

[ -ci Ffile xi ] - pair elements 

File containing base vector, x group size 

power 

[ -ci p/ ] - raise to a power 
power 

root 

[ -ci rf ] - take a root 
root 

round 

[-ci p/ si ] - round to nearest integer, .5 rounds to 1 
places after decimal point, significant digits 

siline 

[-ci ifnisf ] - generate a line given slope and intercept 
intercept, number of positive integers, slope 

sin 

[ -ci ] - sine 

subset 

[-afhfci Ffile ii 1/nl np p/s/ ti] - generate a subset 

above, below, File with master vector, interval, leave, master contains element numbers 
to leave, master contains element numbers to pick, pick, start, terminate 

Summarizers: 

bucket 

[-a/ ci Ffile hfii Ifni ] - break into buckets 

average size. File containing bucket boundaries, high, interval, low, number 

cor 

[-Ffile ] - correlation coefficient 

File containing base vector 

hilo 

[ - h 1 0 ox oy ]- find high and low values 

high only, low only, option form, option form with x prepended, option form with y 
prepended 

Ireg 

[-Ffile i o s ] - linear regression 

File containing base vector, intercept only, option form for siline, slope only 

mean 

[-^n/ p/ ] - (trimmed) arithmetic mean 
fraction, number, percent 

point 

[-^n/ p/s ] - point from empirical cumulative density function 
fraction, number, percent, sorted input 

prod 

- internal product 

qsort 

[ -ci ] - quick sort 

rank 

- vector rank 

total 

- sum total 

var 

- variance 

Translators: 

bar 

[ -a b f g r/ w/ x/ xa y/ ya yl/ yhf ] - build a bar chart 

suppress axes, bold, suppress frame, suppress grid, region, width in percent, x origin, 
suppress x-axis label, y origin, suppress y-axis label, y-axis lower bound, y-axis high 
bound 

hist 

[ -a b f g r/ x/ xa y/ ya yl/ yhf ] - build a histogram 

suppress axes, bold, suppress frame, suppress grid, region, x origin, suppress x-axis 
label, y origin, suppress y-axis label, y-axis lower bound, y-axis high bound 

label 

[-b c Ffile h p r/ X XU y yr ] - label the axis of a GPS file 

bar chart input, retain case, label File, histogram input, plot input, rotation, x-axis, upper 
x-axis, y-axis, right y-axis 
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pie [-bop pn/ pp/ ri \ xi yi ] - build a pie chart 

bold, values outside pie, value as percentage(:=100), value as percentage(:=i), draw 
percent of pie, region, no values, x origin, y origin 
Unlike other nodes, input is lines of the form 
[<iefcc>] value [label] 

ignore (don’t draw) slice, explode slice, fill slice, color slice c=( black, red, green, 
blue) 

plot [-a b cstring d f FJile g m ri xf xa xi/ xhf x\f xni xt yf ya yi/ yhf yl/ yn/ yt ] - plot a 

graph 

suppress axes, bold, plotting characters, disconnected, suppress frame. File containing x 
vector, suppress grid, mark points, region, x origin, suppress x-axis label, x interval, x 
high bound, x low bound, number of ticks on x-axis, suppress x-axis title, y origin, 
suppress y-axis label, y interval, y high bound, y low bound, number of ticks on y-axis, 
suppress y-axis title 

title [ -b c \string \string ustring ] - title a vector or a GPS 

title bold, retain case, lower title, upper title, vector title 

Generators: 

gas [ -ci if ni sftf]- generate additive sequence 

interval, number, start, terminate 

prime [ -ci h/ 1/ ni ] - generate prime numbers 
high, low, number 

rand [ -ci hf 1/ m/ ni si ] - generate random sequence 

high, low, multiplier, number, seed 

RESTRICTIONS 

Some nodes have a limit on the size of the input vector. 

SEE ALSO 

graphicsflG), gps(5). 
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NAME 

strip - remove symbols and relocation bits 

SYNOPSIS 

strip name... 

DESCRIPTION 

Strip removes the symbol table and relocation bits ordinarily attached to the output of the assembler and 
link editor. This is useful to save space after a program has been debugged. 

The effect of strip is the same as use of the -s option of Id. 

If name is an archive file, strip will remove the local symbols from any a.out format files it finds in the 
archive. Certain libraries, such as those residing in /lib, have no need for local symbols. By deleting them, 
the size of the archive is decreased and link editing performance is increased. 

FILES 

/tmp/stm* temporary file 

SEE ALSO 

id(i). 
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NAME 

stty - set the options for a terminal 
SYNOPSIS 

stty [ -a ] [ -g ] [ options ] 


DESCRIPTION 

Stty sets certain terminal I/O options for the device that is the current standard input; without arguments, it 
reports the settings of certain options; with the -a option, it reports all of the option settings; with the -g 
option, it reports current settings in a form that can be used as an argument to another stty command. 
Detailed information about the modes listed in the first five groups below may be found in tty{A). Options 
in the last group are implemented using options in the previous groups. Note that many combinations of 
options make no sense, but no sanity checking is performed. The options are selected from the following: 
Control Modes 

parenb (-parenb) enable (disable) parity generation and detection. 

parodd (-parodd) select odd (even) parity. 

cs5 cs6 cs7 cs8 select character size (see tty{A)). 

0 hang up phone line immediately. 

50 75 110 134 150 200 300 600 1200 1800 2400 4800 9600 exta extb 


Set terminal baud rate to the number given, if possible (these are the speeds sup¬ 
ported by the DH-11 interface). 

hupcl (-hupcl) hang up (do not hang up) DATA-PHONE nh 


hup (-hup) 
cstopb (-cstopb) 
cread (-cread) 
clocal (-clocal) 

Input Modes 

ignbrk (-ignbrk) 
brkint (-brkint) 
ignpar (-ignpar) 
parmrk (-parmrk) 
inpck (-inpck) 
istrip (-istrip) 
inlcr (-inlcr) 
igncr (-igncr) 
icrni (-icrnl) 
iucic (-iuclc) 
ixon (-ixon) 

ixany (-ixany) 
ixoff (-ixoff) 

Output Modes 

opost (-opost) 
olcuc (-olcuc) 
onlcr (-onlcr) 
ocrnl (-ocrnl) 
onocr (-onocr) 
onlret (-oniret) 
ofill (-ofill) 
ofdel (-ofdel) 


connection on last close. 

same as hupcl (-hupcl). 

use two (one) stop bits per character. 

enable (disable) the receiver. 

assume a line without (with) modem control. 

ignore (do not ignore) break on input. 

signal (do not signal) INTR on break. 

ignore (do not ignore) parity errors. 

mark (do not mark) parity errors (see tty{A)). 

enable (disable) input parity checking. 

strip (do not strip) input characters to seven bits. 

map (do not map) NL to CR on input. 

ignore (do not ignore) CR on input. 

map (do not map) CR to NL on input. 

map (do not map) upper-case alphabetics to lower case on input. 

enable (disable) START/STOP output control. Output is stopped by sending an 

ASCII DCS and started by sending an ASCII DCl. 

allow any character (only DCl) to restart output. 

request that the system send (not send) START/STOP characters when the input 
queue is nearly empty/full. 

post-process output (do not post-process output; ignore all other output modes). 

map (do not map) lower-case alphabetics to upper case on output. 

map (do not map) NL to CR-NL on output. 

map (do not map) CR to NL on output. 

do not (do) output CRs at column zero. 

on the terminal NL performs (does not perform) the CR function, 
use fill characters (use timing) for delays, 
fill characters are DHLs (NULs). 
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crO crl cr2 cr3 select style of delay for carriage returns (see tty{A)). 

nlO nil select style of delay for line-feeds (see tfy(4)). 

tabO tabl tab2 tab3 select style of delay for horizontal tabs (see tty{A)). 
bsO bsl select style of delay for backspaces (see tty {A)). 

ffO ffl select style of delay for form-feeds (see tty{A)). 

vtO vtl select style of delay for vertical tabs (see tfy(4)). 

Local Modes 

isig (-isig) enable (disable) the checking of characters against the special control characters 

INTR and QUIT. 

icanon (-icanon) enable (disable) canonical input (ERASE and KILL processing), 
xcase (-xcase) canonical (unprocessed) upper/lower-case presentation, 

echo (-echo) echo back (do not echo back) every character typed. 

echoe (-echoe) echo (do not echo) ERASE character as a backspace-space-backspace string. Note: 

this mode will erase the ERASEed character on many CRT terminals; however, it 
does not keep track of column position and, as a result, may be confusing on 
escaped characters, tabs, and backspaces, 
echok (-echok) echo (do not echo) NL after KILL character. 

Ifkc (-Ifkc) the same as echok (-echok); obsolete. 

echonl (-echonl) echo (do not echo) NL. 

noflsh (-noflsh) disable (enable) flush after INTR or QUIT. 

Control Assignments 

control-character c set control-character to c, where control-character is erase, kill, intr, quit, eof, 
eol, min, or time (min and time are used with -icanon; see tty {A)). If c is pre¬ 
ceded by an (escaped from the shell) caret (''), then the value used is the corre¬ 
sponding CTRL character (e.g., “M” is a CTRL-d); is interpreted as DEL 

and is interpreted as undefined, 
line i set line discipline to i (0 < i < 127 ). 

Combination Modes 

evenp or parity enable parenb and cs7. 

oddp enable parenb, cs7, and parodd. 

-parity, -evenp, or -oddp 

disable parenb, and set cs8. 

raw (-raw or cooked) enable (disable) raw input and output (no ERASE, KILL, INTR, QUIT, EOT, or out¬ 
put post processing). 

nl (-nl) unset (set) icrnl, onlcr. In addition -nl unsets inlcr, igncr, ocrnl, and onlret. 

lease (-lease) set (unset) xcase, iucic, and olcuc. 

LCASE (-LCASE) same as lease (-lease). 

tabs (-tabs or tab3) preserve (expand to spaces) tabs when printing, 
ek reset ERASE and KILL characters back to normal # and @. 

sane resets all modes to some reasonable values. 

term set all modes suitable for the terminal type term, where term is one of tty33, 

tty37, vt05, tn300, ti700, or tek. 


SEE ALSO 


tabs(l), ioctl(2), tty(4). 
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NAME 

su - become super-user or another user 
SYNOPSIS 

su [ - ] [ name [ arg ... ] ] 

DESCRIPTION 

Su allows one to become another user without logging off. The default user name is root (i.e., super-user). 

To use su, the appropriate password must be supplied (unless one is already super-user). If the password is 
correct, su will execute a new shell with the user ID set to that of the specified user. To restore normal user 
ID privileges, type an EOF to the new shell. 

Any additional arguments are passed to the shell, permitting the super-user to run shell procedures with 
restricted privileges (an arg of the form -c string executes string via the shell). When additional argu¬ 
ments are passed, /bin/sh is always used. When no additional arguments are passed, su uses the shell 
specified in the password file. 

An initial - flag causes the environment to be changed to the one that would be expected if the user actually 
logged in again. This is done by invoking the shell with an argO of -su causing the .profile in the home 
directory of the new user ID to be executed. Otherwise, the environment is passed along with the possible 
exception of $PATH, which is set to /bin:/etc:/usr/biii for root. Note that the .profile can check argO for 
-sh or -su to determine how it was invoked. 

FILES 

/etc/passwd system’s password file 

$HOME/.profile user’s profile 

SEE ALSO 

env(l), login(l), sh(l), environ(7). 
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NAME 

sum - sum and count blocks in a file 

SYNOPSIS 

sum [ -r ] file 

DESCRIPTION 

Sum calculates and prints a 16-bit checksum for the named file, and also prints the number of blocks in the 
file. It is typically used to look for bad spots, or to validate a file communicated over some transmission 
line. The option -r causes an alternate algorithm to be used in computing the checksum. 

SEE ALSO 

wc(l). 

DIAGNOSTICS 

“Read error” is indistinguishable from end of file on most devices; check the block count. 
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NAME 

sync - update the super block 

SYNOPSIS 

sync 

DESCRIPTION 

Sync executes the sync system primitive. If the system is to be stopped, sync must be called to insure file 
system integrity. See sync{2) for details. 

SEE ALSO 

sync(2). 
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NAME 

sysdef - system definition 
SYNOPSIS 

/etc/sysdef [opsys [master]] 

DESCRIPTION 

Sysdef analyzes the named operating system file and extracts configuration information. This includes all 
hardware devices, their addresses, interrupt vectors and unit count, as well as system devices and all tunable 
parameters. 

The output of sysdef can be used directly by configflM) to regenerate the appropriate low.s (univec.c on 
the VAX-11/780) and conf.c configuration files. 

FILES 

/unix default operating system file 

/etc/master default table for hardware specifications 

DIAGNOSTICS 

‘ ‘unknown device interrupts at vector xxx’ ’ if information regarding the device cannot be found in the mas¬ 
ter table. 

SEE ALSO 

config(lM), master(5). 

BUGS 

As yet, sysdef nothing of devices that are not interrupt driven. 

Because information regarding config aliases is not preserved by the system, device names returned might 
not be accurate. 
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NAME 

tabs - set tabs on a terminal 
SYNOPSIS 

tabs [ tabspec ] [ +mn ] [ -Ttype ] 

DESCRIPTION 

Tabs sets the tab stops on the user’s terminal according to the tab specification tabspec, after clearing any 
previous settings. The user must of course be logged in on a terminal with remotely-settable hardware tabs. 

Users of GE TermiNet terminals should be aware that they behave in a different way than most other termi¬ 
nals for some tab settings: the first number in a list of tab settings becomes the left margin on a TermiNet 
terminal. Thus, any list of tab numbers whose first element is other than 1 causes a margin to be left on a 
TermiNet, but not on other terminals. A tab list beginning with 1 causes the same effect regardless of ter¬ 
minal type. It is possible to set a left margin on some other terminals, although in a different way (see 
below). 

Four types of tab specification are accepted for tabspec: “canned,” repetitive, arbitrary, and file. If no 
tabspec is given, the default value is -8, i.e., UNIX “standard” tabs. The lowest column number is 1. Note 
that for tabs, column 1 always refers to the leftmost column on a terminal, even one whose column markers 
begin at 0, e.g., the DASI 300, DASI 300s, and DASI450. 

-code Gives the name of one of a set of “canned” tabs. The legal codes and their meanings are as fol¬ 
lows: 

-a 1,10,16,36,72 

Assembler, IBM S/370, first format 
-a2 1,10,16,40,72 

Assembler, IBM S/370, second format 
-c 1,8,12,16,20,55 

COBOL, normal format 
-c2 1,6,10,14,49 

COBOL compact format (columns 1-6 omitted). Using this code, the first typed character corre¬ 
sponds to card column 7, one space gets you to column 8, and a tab reaches column 12. Files 
using this tab setup should include a format specification as follows: 

<:t-c2 in6 s66 d:> 

-c3 1,6,10,14,18,22,26,30,34,38,42,46,50,54,58,62,67 

COBOL compact format (columns 1-6 omitted), with more tabs than -c2. This is the recom¬ 
mended format for COBOL. The appropriate format specification is: 

<:t-c3 m6 s66 d:> 

-f 1,7,11,15,19,23 

FORTRAN 

-p 1,5,9,13,17,21,25,29,33,37,41,45,49,53,57,61 

PL/I 

-s 1,10,55 

SNOBOL 

-u 1,12,20,44 

UNIVAC 1100 Assembler 

In addition to these “canned” formats, three other types exist: 

-n A repetitive specification requests tabs at columns \+n, \+2*n, etc. Note that such a setting 

leaves a left margin of n columns on TermiNet terminals only. Of particular importance is the 
value -8: this represents the UNIX “standard” tab setting, and is the most likely tab setting to be 
found at a terminal. It is required for use with the nroff(l) -h option for high-speed output. 
Another special case is the value -0, implying no tabs at all. 
nl ,n2,... The arbitrary format permits the user to type any chosen set of numbers, separated by commas, in 
ascending order. Up to 40 numbers are allowed. If any number (except the first one) is preceded 
by a plus sign, it is taken as an increment to be added to the previous value. Thus, the tab lists 
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1,10,20,30 and 1,10,+10,+ 10 are considered identical. 

—file If the name of a file is given, tabs reads the first line of the file, searching for a format 

specification. If it finds one there, it sets the tab stops according to it, otherwise it sets them as 
-8. This type of specification may be used to make sure that a tabbed file is printed with correct 
tab settings, and would be used with thepr(l) command: 
tabs — file; pr file 

Any of the following may be used also; if a given flag occurs more than once, the last value given takes 
effect: 


-Ttype Tabs usually needs to know the type of terminal in order to set tabs and always needs to know the 
type to set margins. Type is a name listed in term(J). If no -T flag is supplied, tabs searches for 
the $TERM value in the environment (see environij)). If no type can be found, tabs tries a 
sequence that will work for many terminals. 

+inn The margin argument may be used for some terminals. It causes all tabs to be moved over n 
columns by making column n+l the left margin. If +m is given without a value of n, the value 
assumed is 10. For a TermiNet, the first value in the tab list should be 1, or the margin will move 
even further to the right. The normal (leftmost) margin on most terminals is obtained by +m0. 
The margin for most terminals is reset only when the +m flag is given explicitly. 

Tab and margin setting is performed via the standard output. 


DIAGNOSTICS 

illegal tabs 
illegal increment 
unknown tab code 
can't open 
file indirection 


when arbitrary tabs are ordered incorrectly. 

when a zero or missing increment is found in an arbitrary specification, 
when a “canned” code cannot be found, 
if —file option used, and file can’t be opened. 

if —file option used and the specification in that file points to yet another file. Indirec¬ 
tion of this form is not permitted. 


SEE ALSO 

nroff(l), environ(7), term(7). 


BUGS 

There is no consistency among different terminals regarding ways of clearing tabs and setting the left mar¬ 
gin. 

It is generally impossible to usefully change the left margin without also setting tabs. 

Tabs clears only 20 tabs (on terminals requiring a long sequence), but is willing to set 40. 
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NAME 

tail - deliver the last part of a file 
SYNOPSIS 

tail [ ±[number][lbc] [ -f ] ] [ file ] 

DESCRIPTION 

Tail copies the named file to the standard output beginning at a designated place. If no file is named, the 
standard input is used. 

Copying begins at distance +number from the beginning, or -number from the end of the input (if number 
is null, the value 10 is assumed). Number is counted in units of lines, blocks, or characters, according to 
the appended option I, b, or c. When no units are specified, counting is by lines. 

With the -f (“follow”) option, if the input file is not a pipe, the program will not terminate after the line of 
the input file has been copied, but will enter an endless loop, wherein it sleeps for a second and then 
attempts to read and copy further records from the input file. Thus it may be used to monitor the growth of 
a file that is being written by some other process. For example, the command: 

tail -f fred 

will print the last ten lines of the file fred, followed by any lines that are appended to fred between the time 
tail is initiated and killed. 

SEE ALSO 

dd(l). 

BUGS 

Tails relative to the end of the file are treasured up in a buffer, and thus are limited in length. Various kinds 
of anomalous behavior may happen with character special files. 
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NAME 

tar - tape file archiver 

SYNOPSIS 

tar [ key ] [ files ] 

DESCRIPTION 

Tar saves and restores files on magnetic tape. Its actions are controlled by the key argument. The key is a 
string of characters containing at most one function letter and possibly one or more function modifiers. 
Other arguments to the command are files (or directory names) specifying which files are to be dumped or 
restored. In all cases, appearance of a directory name refers to the files and (recursively) subdirectories of 
that directory. 

The function portion of the key is specified by one of the following letters: 

r The namedare written on the end of the tape. The c function implies this function. 

X The named files are extracted from the tape. If a named file matches a directory whose contents 

had been written onto the tape, this directory is (recursively) extracted. The owner, modification 
time, and mode are restored (if possible). If no files argument is given, the entire content of the 
tape is extracted. Note that if several files with the same name are on the tape, the last one over¬ 
writes all earlier ones. 

t The names of the specified files are listed each time that they occur on the tape. If no files argu¬ 

ment is given, all the names on the tape are listed. 

u The named files are added to the tape if they are not already there, or have been modified since 

last written on that tape. 

c Create a new tape; writing begins at the beginning of the tape, instead of after the last file. This 

command implies the r function. 

The following characters may be used in addition to the letter that selects the desired function: 

This modifier selects the drive on which the tape is mounted. The default is 1. 

V Normally, tar does its work silently. The v (verbose) option causes it to type the name of each 

file it treats, preceded by the function letter. With the t function, v gives more information about 
the tape entries than just the name. 

w causes tar to print the action to be taken, followed by the name of the file, and then wait for the 

user’s confirmation. If a word beginning with y is given, the action is performed. Any other 
input means “no”. 

f causes tar to use the next argument as the name of the archive instead of /dev/mt?. If the name 

of the file is -, tar writes to the standard output or reads from the standard input, whichever is 

appropriate. Thus, tar can be used as the head or tail of a pipeline. Tar can also be used to move 
hierarchies with the command: 

cd fromdir; tar cf - . I (cd todir; tar xf -) 

b causes tar to use the next argument as the blocking factor for tape records. The default is 1, the 

maximum is 20. This option should only be used with raw magnetic tape archives (see f above). 
The block size is determined automatically when reading tapes (key letters x and t). 

1 tells tar to complain if it cannot resolve all of the links to the files being dumped. If I is not 

specified, no error messages are printed. 

m tells tar to not restore the modification times. The modification time of the file will be the time of 

extraction. 


FILES 

/dev/mt? 

/tmp/tar* 

DIAGNOSTICS 

Complaints about bad key characters and tape read/write errors. 
Complaints if enough memory is not available to hold the link tables. 
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BUGS 

There is no way to ask for the «-th occurrence of a file. 

Tape errors are handled ungracefully. 

The u option can be slow. 

The b option should not be used with archives that are going to be updated. The current magnetic tape 
driver cannot backspace raw magnetic tape. If the archive is on a disk file, the b option should not be used 
at all, because updating an archive stored on disk can destroy it. 

The current limit on file-name length is 100 characters. 
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NAME 

tbl - format tables for nroff or troff 

SYNOPSIS 

tbl [ -TX ] [ files ] 

DESCRIPTION 

Tbl is a preprocessor that formats tables for nrojf{\) or trojf{\). The input files are copied to the standard 
output, except for lines between .TS and .TE command lines, which are assumed to describe tables and are 
re-formatted by tbl. (The .TS and .TE command lines are not altered by tbl). 

.TS is followed by global options. The available global options are: 

center center the table (default is left-adjust); 
expand make the table as wide as the current line length; 
box enclose the table in a box; 

doublebox enclose the table in a double box; 
allbox enclose each item of the table in a box; 

tab (x) use the character x instead of a tab to separate items in a line of input data. 

The global options, if any, are terminated with a semi-colon (;). 

Next come lines describing the format of each line of the table. Each such format line describes one line of 
the actual table, except that the last format line (which must end with a period) describes all remaining 
lines of the table. Each column of each line of the table is described by a single key-letter, optionally fol¬ 
lowed by specifiers that determine the font and point size of the corresponding item, that indicate where 
vertical bars are to appear between columns, that determine column width, inter-column spacing, etc. The 
available key-letters are: 

c center item within the column; 

r right-adjust item within the column; 

1 left-adjust item within the column; 

n numerically adjust item in the column: units positions of numbers are aligned vertically; 

s span previous item on the left into this column; 

a center longest line in this column and then left-adjust all other lines in this column with 

respect to that centered line; 
span down previous entry in this column; 

_ replace this entry with a horizontal line; 

= replace this entry with a double horizontal line. 

The characters B and I stand for the bold and italic fonts, respectively; the character I indicates a vertical 
line between columns. 

The format lines are followed by lines containing the actual data for the table, followed finally by .TE. 
Within such data lines, data items are normally separated by tab characters. 

If a data line consists of only _ or =, a single or double line, respectively, is drawn across the table at that 
point; if a single item in a data line consists of only _ or =, then that item is replaced by a single or double 
line. 

Full details of all these and other features of tbl are given in the reference manual cited below. 

The -TX option forces tbl to use only full vertical line motions, making the output more suitable for devices 
that cannot generate partial vertical line motions (e.g., line printers). 

If no file names are given as arguments, tbl reads the standard input, so it may be used as a filter. When it 
is used with eqn(l) or neqn(\), tbl should come first to minimize the volume of data passed through pipes. 

EXAMPLE 

If we let ^ represent a tab (which should be typed as a genuine tab), then the input: 
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.TS 

center box ; 
cB s s 
cl I cl s 
^ I c c 
linn. 

Household Population 

Town—^Households 
—^Number—>Size 

Bedminster—>789^3.26 
Bernards Twp.^3087^3.74 
Bernardsville—>2018—>3.30 
Bound Brook^3425^3.04 
Bridgewater^7897^3.81 
Far Hills^240^3.19 
.TE 

yields: 

center box ; cB s s cl I cl s " I c c 1 I n n . Household Population _ Town Households 
Number Size = Bedminster 789 3.26 Bernards Twp. 3087 3.74 Bernards- 

ville 2018 3.30 Bound Brook 3425 3.04 Bridgewater 7897 3.81 Far 

Hills240 3.19 

SEE ALSO 

TBL-A Program to Format Tables by M. E. Lesk 
eqn(l), mm(l), mmt(l), troff(l), mm(7), mv(7). 

BUGS 


See BUGS under trojf{\). 
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NAME 

tc - phototypesetter simulator 
SYNOPSIS 

tc [ -t ] [ -sii ] [ -pi ] [ file ] 

DESCRIPTION 

Tc interprets its input (standard input default) as device codes for a Wang Laboratories, Inc. C/A/T photo¬ 
typesetter. The standard output of tc is intended for a Tektronix 4014 terminal with ASCII and APL charac¬ 
ter sets. The sixteen typesetter sizes are mapped into the 4014’s four sizes; the entire TROFF character set is 
drawn using the 4014’s character generator, with overstruck combinations where necessary. Typical usage 
is: 

troff -t files I tc 

At the end of each page, tc waits for a new-line (empty line) from the keyboard before continuing on to the 
next page. In this wait state, the command e will suppress the screen erase before the next page; sn will 
cause the next n pages to be skipped; and \cmd will send cmd to the shell. 

The command line options are: 

-t Don’t wait between pages (for directing output into a file). 

-sn Skip the first n pages. 

-pi Set page length to /; / may include the scale factors p (points), i (inches), c (centimeters), and P 
(picas); default is picas. 

SEE ALSO 

4014(1), sh(l), tplot(lG), troff(l). 

BUGS 

Font distinctions are lost. 
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NAME 

tee - pipe fitting 
SYNOPSIS 

tee [ -i ] [ -a ] [ file ] ... 

DESCRIPTION 

Tee transcribes the standard input to the standard output and makes copies in the files. The -i option 
ignores interrupts; the -a option causes the output to be appended to iht files rather than overwriting them. 
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NAME 

test - condition evaluation command 

SYNOPSIS 

test expr 
[ expr] 

DESCRIPTION 

Test evaluates the expression expr and, if its value is true, returns a zero (true) exit status; otherwise, a 
non-zero (false) exit status is returned; test also returns a non-zero exit status if there are no arguments. 
The following primitives are used to construct expr: 

-rfile true if file exists and is readable. 

-w file true if file exists and is writable. 

-X file true if file exists and is executable. 

-f file true if file exists and is a regular file. 

-d file true if file exists and is a directory. 

-cfile true if file exists and is a character special file. 

-b file true if file exists and is a block special file. 

-u file true if file exists and its set-user-ID bit is set. 

-gfile true if file exists and its set-group-ID bit is set. 

-k file true if file exists and its sticky bit is set. 

-s file true if file exists and has a size greater than zero. 

-t [fildes ] true if the open file whose file descriptor number is fildes (1 by default) is associated with a 

terminal device. 

-z si true if the length of string si is zero. 

-n si true if the length of the string si is non-zero. 

si = s2 true if strings si and s2 are identical. 

si != s2 true if strings si and s2 are not identical. 

si true if si is not the null string. 

nl -eq n2 true if the integers nl and n2 are algebraically equal. Any of the comparisons -ne, -gt, -ge, 
-It, and -le may be used in place of -eq. 

These primaries may be combined with the following operators: 

! unary negation operator. 

-a binary and operator. 

-o binary or operator (-a has higher precedence than -o). 

( expr ) parentheses for grouping. 

Notice that all the operators and flags are separate arguments to test. Notice also that parentheses are mean¬ 
ingful to the shell and, therefore, must be escaped. 

SEE ALSO 

find(l), sh(l). 

WARNING 

In the second form of the command (i.e., the one that uses [], rather than the word test), the square brackets 
must be delimited by blanks. 
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NAME 

time - time a command 

SYNOPSIS 

time command 

DESCRIPTION 

The given command is executed; after it is complete, time prints the elapsed time during the command, the 
time spent in the system, and the time spent in execution of the command. Times are reported in seconds. 

The execution time can depend on what kind of memory the program happens to land in; the user time in 
MOS is often half what it is in core. 

The times are printed on standard error. 

SEE ALSO 

timex(l), times(2). 
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NAME 

timex - time a command and generate a system activity report 

SYNOPSIS 

timex command 

DESCRIPTION 

The given command is executed; after its execution, timex prints the elapsed time, the time spent executing 
command, and the time spent in the system, as time{l) does. It also reports system activity that occurred 
during command execution, including CPU utilization, I/O activity, system switching and swapping, and file 
system access. All system activity is reported, not just that due to command. 

The output of timex is written on standard error. 

SEE ALSO 

time(l), sar(8). 
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NAME 

toe - graphical table of contents routines 

SYNOPSIS 

dtoc [directory] 
ttoc mm-file 

vtoc [-chnimsvn] [TTOC file] 

DESCRIPTION 

All of the commands listed below reside in /usr/bin/graf (see graphics(IG)). 

dtoc Dtoc makes a textual table of contents, TTOC, of all subdirectories beginning at directory 

{directory defaults to .). The list has one entry per directory. The entry fields from left to right 
are level number, directory name, and the number of ordinary readable files in the directory. 
Dtoc is useful in making a visual display of all or parts of a file system. The following will 
make a visual display of all the readable directories under /: 
dtoc/ I vtoc I td 

ttoc Output is the table of contents generated by the .TC macro of mm(l) translated to TTOC format. 

The input is assumed to be a mm file that uses the .H family of macros for section headers. If 
no file is given, the standard input is assumed. 

vtoc Vtoc produces a GPS describing a hierarchy chart from a TTOC. The output drawing consists 

of boxes containing text connected in a tree structure. If no file is given, the standard input is 
assumed. Each TTOC entry describes one box and has the form: 
id [line-weight,line-style] "text" [mark] 

where: 


id 


line-weight 


line-style 


text 


mark 


is an alternating sequence of numbers and dots. The id specifies the position of 
the entry in the hierarchy. The id 0. is the root of the tree. 

is either: 

n, normal-weight; or 
m, medium-weight; or 
b, bold-weight. 

is either: 

so, solid-line; 
do, dotted-line; 
dd, dot-dash line; 
da, dashed-line; or 
Id, long-dashed 

is a character string surrounded by quotes. The characters between the quotes 
become the contents of the box. To include a quote within a box it must be 
escaped (\"). 

is a character string (surrounded by quotes if it contains spaces), with included 
dots being escaped. The string is put above the top right corner of the box. To 
include either a quote or a dot within a mark it must be escaped. 


Entry example: 1.1 b,da "ABC" DEF 

Entries may span more than one line by escaping the new-line (\new‘line). 
Comments are surrounded by the /*,*/ pair. They may appear anywhere in a TTOC. 


Options: 

c Use text as entered, (default is all upper case). 
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hn Horizontal interbox space is « % of box width, 
i Suppress the box id. 

m Suppress the box mark. 

s Do not compact boxes horizontally. 

\n Vertical interbox space is « % of box height. 

SEE ALSO 

graphics(lG), gps(5). 
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NAME 

touch - update access and modification times of a file 
SYNOPSIS 

touch [ -amc ] [ mmddhhmm[yy] ] files 
DESCRIPTION 

Touch causes the access and modification times of each argument to be updated. If no time is specified (see 
dateil)) the current time is used. The -a and -m options cause touch to update only the access or 
modification times respectively (default is -am). The -c option silently prevents touch from creating the 
file if it did not previously exist. 

The return code from touch is the number of files for which the times could not be successfully modified 
(including files that did not exist and were not created). 

SEE ALSO 

date(l), utime(2). 
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NAME 

tp - manipulate tape archive 

SYNOPSIS 

tp [ key ] [ name ... ] 

DESCRIPTION 

Tp saves and restores files on DECtape or other magnetic tape. Its actions are controlled by the key argu¬ 
ment. The key is a string of characters containing at most one function letter and possibly one or more 
function modifiers. Other arguments to the command are file or directory names specifying which files are 
to be dumped, restored, or listed. In all cases, appearance of a directory name refers to the files and (recur¬ 
sively) subdirectories of that directory. 

The function portion of the key is specified by one of the following letters: 

r The named files are written on the tape. If files with the same names already exist, they are 

replaced. “Same” is determined by string comparison, so ./abc can never be the same as 
/usr/sbo/abc even if /usr/sbo is the current directory. If no file argument is given,. is the default. 

u Updates the tape, u is like r, but a file is replaced only if its modification date is later than the 

date stored on the tape; that is to say, if it has changed since it was dumped, u is the default com¬ 
mand if none is given. 

d Deletes the named files from the tape. At least one name argument must be given. This function 

is not permitted on magnetic tapes. 

X Extracts the named files from the tape to the file system. The owner and mode are restored. If no 

file argument is given, the entire contents of the tape are extracted. 

t Lists the names of the specified files. If no file argument is given, the entire contents of the tape 

is listed. 

The following characters may be used in addition to the letter which selects the function desired, 
m Specifies magnetic tape as opposed to DECtape. 

0,...,7 This modifier selects the drive on which the tape is mounted. For DECtape, x is default; for 
magnetic tape 0 is the default. 

V Normally tp does its work silently. The v (verbose) option causes it to type the name of each 

file it treats preceded by the function letter. With the t function, v gives more information 
about the tape entries than just the name. 

c Means a fresh dump is being created; the tape directory is cleared before beginning. Usable 

only with r and u. This option is assumed with magnetic tape since it is impossible to selec¬ 
tively overwrite magnetic tape. 

i Errors reading and writing the tape are noted, but no action is taken. Normally, errors cause a 

return to the command level. 

f Use the first named file, rather than a tape, as the archive. This option is known to work only 

with X. 

w Causes tp to pause before treating each file, type the indicative letter and the file name (as with 

v) and await the user’s response. Response y means “yes”, so the file is treated. Null 
response means “no”, and the file does not take part in whatever is being done. Response x 
means “exit”; the tp command terminates immediately. In the x function, files previously 
asked about have been extracted already. With r, u, and d no change has been made to the 
tape. 

FILES 

/dev/tap? 

/dev/mt? 
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SEE ALSO 

ar(l), cpio(l), tar(l). 

DIAGNOSTICS 

Several; the non-obvious one is “Phase error”, which means the file changed after it was selected for 
dumping but before it was dumped. 

BUGS 

A single file with several links to it is treated like several files. 

Binary-coded control information makes magnetic tapes written by tp difficult to carry to other machines; 
tar{\) avoids the problem. 

Tp does not copy zero-length files to tape. 
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NAME 

tplot - graphics filters 
SYNOPSIS 

tplot [ -Tterminal [ -e raster ] ] 

DESCRIPTION 

These commands read plotting instructions (see plot{5)) from the standard input and in general produce, on 
the standard output, plotting instructions suitable for a particular terminal. If no terminal is specified, the 
environment parameter $TERM (see environil)) is used. Known terminals are: 

300 DASI300. 

300S DASI 300s. 

450 DASI 450. 

4014 Tektronix 4014. 

ver Versatec D1200A. This version of plot places a scan-converted image in /usr/tmp/raster$$ and 
sends the result directly to the plotter device, rather than to the standard output. The -e option 
causes a previously scan-converted file raster to be sent to the plotter. 

FILES 

/usr/lib/t300 

/usr/lib/t300s 

/usr/lib/t450 

/usr/lib/t4014 

/usr/lib/vplot 

/usr/tmp/raster$$ 

SEE ALSO 

plot(3X), plot(5), term(7). 
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NAME 

tr - translate characters 
SYNOPSIS 

tr [ -cds ] [ string 1 [ string! ] ] 

DESCRIPTION 

Tr copies the standard input to the standard output with substitution or deletion of selected characters. 
Input characters found in string 1 are mapped into the corresponding characters of string!. Any combina¬ 
tion of the options -cds may be used: 

-c Complements the set of characters in stringl with respect to the universe of characters whose 

ASCII codes are 001 through 377 octal. 

-d Deletes all input characters in stringl. 

-s Squeezes all strings of repeated output characters that are in string! to single characters. 

The following abbreviation conventions may be used to introduce ranges of characters or repeated charac¬ 
ters into the strings: 

[a-z] Stands for the string of characters whose ASCII codes run from character a to character z, inclu¬ 
sive. 

[a*n] Stands for n repetitions of a. If the first digit of n is 0, « is considered octal; otherwise, n is taken 
to be decimal. A zero or missing n is taken to be huge; this facility is useful for padding string!. 

The escape character \ may be used as in the shell to remove special meaning from any character in a string. 
In addition, \ followed by 1, 2, or 3 octal digits stands for the character whose ASCII code is given by those 
digits. 

The following example creates a list of all the words in file 1 one per line in file!, where a word is taken to 
be a maximal string of alphabetics. The strings are quoted to protect the special characters from interpreta¬ 
tion by the shell; 012 is the ASCII code for newline. 

tr -cs "[A-Z][a-z]" "[\012*]" <filel >file2 

SEE ALSO 

ed(l), sh(l), ascii(7). 

BUGS 

Won’t handle ASCII NUL in stringl or string!-, always deletes NUL from input. 
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NAME 

troff, nroff - typeset or format text 
SYNOPSIS 

nroff [ options ] [ files ] 
troff [ options ] [ files ] 

DESCRIPTION 

Nrojf formats text contained in files (standard input by default) for printing on typewriter-like devices and 
line printers; similarly, trojf formats text for a Wang Laboratories, Inc., C/A/T phototypesetter. Their capa¬ 
bilities are described in the NROFF/TROFF User’s Manual cited below. 

An argument consisting of a minus (-) is taken to be a file name corresponding to the standard input. The 
options, which may appear in any order, but must appear before files, are: 

-olist Print only pages whose page numbers appear in the list of numbers and ranges, separated by 
commas. A range N-M means pages N through M; an initial -N means from the beginning to 
page A; and a final N- means from N to the end. (See BUGS below.) 

-nA Number first generated page A. 

-sA Stop every A pages. Nroff will halt after every A pages (default A=l) to allow paper loading or 
changing, and will resume upon receipt of a line-feed or new-line (new-lines do not work in pipe¬ 
lines, e.g., with mm(l)). This option does not work if the output of nroff is piped through col{l). 
Troff will stop the phototypesetter every A pages, produce a trailer to allow changing cassettes, 
and resume when the typesetter’s start button is pressed. When nroff (troff) halts between pages, 
an ASCII BEL (in troff, the message page stop) is sent to the terminal. 

-raA Set register a (which must have a one-character name) to A. 

-i Read standard input oTier files are exhausted. 

-q Invoke the simultaneous input-output mode of the .rd request. 

-z Print only messages generated by .tm (terminal message) requests. 

-mname Prepend to the input files the non-compacted (ASCII text) macro file /usr/lib/tmac/tmac.«ame. 
-cname Prepend to the input files the compacted macro files /usr/lib/inacros/cmp.[nt].[dt].niime and 
/usr/Iib/macros/ucmp. [nt] .name. 

-kname Compact the macros used in this invocation of nroff/troff, placing the output in files [Ai\.name in 
the current directory (see the May 1979 Addendum to the NROFF/TROFF User’s Manual for 
details of compacting macro files). 

Nroff only; 

-Tname Prepare output for specified terminal. Known names are 37 for the (default) TELETYPE.nh 

Model 37 terminal, tn300 for the GE TermiNet 300 (or any terminal without half-line capability), 
300s for the DASI 300s, 300 for the DASI 300, 450 for the DASI450, Ip for a (generic) ASCII line 
printer, 382 for the DTC-382, 4000A for the Trendata 4000A, 832 for the Anderson Jacobson 
832, X for a (generic) EBCDIC printer, and 2631 for the Hewlett Packard 2631 line printer. 

-e Produce equally-spaced words in adjusted lines, using the full resolution of the particular termi¬ 

nal. 

-h Use output tabs during horizontal spacing to speed output and reduce output character count. Tab 
settings are assumed to be every 8 nominal character widths. 

-Urt Set the emboldening factor (number of character overstrikes) for the third font position (bold) to 
n, or to zero if n is missing. 

Troff only: 

-t Direct output to the standard output instead of the phototypesetter. 

-f Refrain from feeding out paper and stopping phototypesetter at the end of the run. 

-w Wait until phototypesetter is available, if it is currently busy. 

-b Report whether the phototypesetter is busy or available. No text processing is done. 

-a Send a printable ASCII approximation of the results to the standard output. 
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-pA^ Print all characters in point size N while retaining all prescribed spacings and motions, to reduce 
phototypesetter elapsed time. 

-g Prepare output for the Murray Hill Computation Center phototypesetter and direct it to the stan¬ 

dard output (see gcat(\C)). This option is not compatible with the -s option; furthermore, when 
this option is invoked, all .fp (font position) requests (if any) in the trojf input must come before 
the first break, and no .tl requests may come before the first break. 

-Tname Use font-width tables for device name (the font tables are found in /usr/lib/font/n^zme/*). Cur¬ 
rently, no names are supported. 

FILES 

/usr/lib/suftab suffix hyphenation tables 

/tmp/taS# temporary file 

/usr/lib/tmac/tmac.* standard macro files and pointers 
/usr/lib/macros/* standard macro files 

/usr/lib/term/* terminal driving tables for nrojf 

/usr/lib/font/* font width tables for trojf 

SEE ALSO 

NROFF/TROFF User’s Manual by J. F. Ossanna. 

A TROFF Tutorial by B. W. Kernighan. 
eqn(l), tbl(l), mm(7). 
col(l), greek(l), mm(l) {nrojf only). 
gcat(lC), mmt(l), tc(l), mv(7) {troff only). 

BUGS 

Nrojf/trojf believes in Eastern Standard Time; as a result, depending on the time of the year and on your 
local time zone, the date that nroff/troff generates may be off by one day from your idea of what the date is. 
When nroff/troff is used with the -olist option inside a pipeline (e.g., with one or more of cw(l), eqn{l), 
and tbl(l)), it may cause a harmless “broken pipe” diagnostic if the last page of the document is not 
specified in list. 



TRUE(l) 


TRUE(l) 


NAME 

true, false - provide truth values 

SYNOPSIS 

true 

false 

DESCRIPTION 

True does nothing, successfully. False does nothing, unsuccessfully. They are typically used in input to 
sh(\) such as: 

while true do 

command 

done 

SEE ALSO 

sh(l). 

DIAGNOSTICS 

True has exit status zero, false nonzero. 
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NAME 

tsort - topological sort 

SYNOPSIS 

tsort [ file ] 

DESCRIPTION 

Tsort produces on the standard output a totally ordered list of items consistent with a partial ordering of 
items mentioned in the input If no file is specified, the standard input is understood. 

The input consists of pairs of items (nonempty strings) separated by blanks. Pairs of different items indi¬ 
cate ordering. Pairs of identical items indicate presence, but not ordering. 

SEE ALSO 

lorder(l). 

DIAGNOSTICS 

Odd data: there is an odd number of fields in the input file. 

BUGS 

Uses a quadratic algorithm; not worth fixing for the typical use of ordering a library archive file. 
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NAME 

tty - get the terminal’s name 

SYNOPSIS 

tty[-s] 

DESCRIPTION 

Tty prints the path name of the user’s terminal. The -s option inhibits printing, allowing one to test just the 
exit code. 

EXIT CODES 

0 if standard input is a terminal, 

1 otherwise. 

DIAGNOSTICS 

‘ ‘not a tty” if the standard input is not a terminal and -s is not specified. 
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NAME 

typo - find possible typographical errors 

SYNOPSIS 

typo [ -n ] [ files ] 

DESCRIPTION 

Typo hunts through a document for unusual words, typographic errors, and hapax legomena and prints 
them on the standard output. 

The words used in the document are printed out in decreasing order of peculiarity along with an index of 
peculiarity. An index of 10 or more is considered peculiar. Printing of certain very common English words 
is suppressed. 

The statistics forjudging words are taken from the document itself, with some help from known statistics of 
English. The -n option suppresses the help from English and should be used if the document is written in, 
for example, Urdu. 

Trojf{\) control lines are ignored. Quote marks, vertical bars, hyphens, and ampersands within words are 
equivalent to spaces. Words hyphenated across lines are put back together. 

FILES 

/tmp/ttmp?? 

/usr/lib/salt 

/usr/lib/w2006 

SEE ALSO 

spell(l). 
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NAME 

□mask - set file-creation mode mask 

SYNOPSIS 

umask [ ooo ] 

DESCRIPTION 

The user file-creation mode mask is set to ooo. The octal three digits refer to read/write/execute permis¬ 
sions for owner, group, and others, respectively (see chmodil) and umask{2)). The value of each specified 
digit is subtracted from the corresponding “digit” specified by the system for the creation of a file (see 
creat{T)). For example, umask 022 removes group and others write permission (files normally created 
with mode 111 become mode 755; files created created with mode 666 become mode 644). 

If ooo is omitted, the current value of the mask is printed. 

Umask is recognized and executed by the shell. 

SEE ALSO 

chmod(l), sh(l), chmod(2), creat(2), umask(2). 
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NAME 

□name - print name of current UNIX 

SYNOPSIS 

uname [ -snrva ] 

DESCRIPTION 

Uname prints the current system name of UNIX on the standard output file. It is mainly useful to determine 
what system one is using. The options cause selected information returned by uname{2) to be printed: 

-s print the system name (default). 

-n print the nodename (the nodename may be a name that the system is known by to a communica¬ 
tions network). 

-r print the operating system release. 

-V print the operating system version. 

-a print all the above information. 

SEE ALSO 

uname(2). 
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NAME 

unget - undo a previous get of an SCCS file 
SYNOPSIS 

unget [-rSID] [-s] [-n] files 
DESCRIPTION 

Unget undoes the effect of a get -e done prior to creating the intended new delta. If a directory is named, 
unget behaves as though each file in the directory were specified as a named file, except that non-SCCS files 
and unreadable files are silently ignored. If a name of - is given, the standard input is read with each line 
being taken as the name of an SCCS file to be processed. 

Keyletter arguments apply independently to each named file. 

-rSID Uniquely identifies which delta is no longer intended. (This would have been 

specified by get as the “new delta”). The use of this keyletter is necessary only if 
two or more outstanding gets, for editing on the same SCCS file were done by the same 
person (login name). A diagnostic results if the specified SID is ambiguous, or if it is 
necessary and omitted on the command line. 

-s Suppresses the printout, on the standard output, of the intended delta’s SID. 

-n Causes the retention of the gotten file which would normally be removed from the cur¬ 

rent directory. 

SEE ALSO 

delta(l), get(l), sact(l). 

DIAGNOSTICS 

Use help{\) for explanations. 
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NAME 

uniq - report repeated lines in a file 
SYNOPSIS 

uniq [ -udc [ +n ] [ -n ] ] [ input [ output ] ] 

DESCRIPTION 

Uniq reads the input file comparing adjacent lines. In the normal case, the second and succeeding copies of 
repeated lines are removed; the remainder is written on the output file. Input and output should always be 
different. Note that repeated lines must be adjacent in order to be found; see i'orf(l). If the -u flag is used, 
just the lines that are not repeated in the original file are output. The -d option specifies that one copy of 
just the repeated lines is to be written. The normal mode output is the union of the -u and -d mode out¬ 
puts. 

The -c option supersedes -u and -d and generates an output report in default style but with each line pre¬ 
ceded by a count of the number of times it occurred. 

The n arguments specify skipping an initial portion of each line in the comparison: 

-n The first n fields together with any blanks before each are ignored. A field is defined as a string 
of non-space, non-tab characters separated by tabs and spaces from its neighbors. 

+n The first n characters are ignored. Fields are skipped before characters. 

SEE ALSO 

comm(l), sort(l). 
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NAME 

units - conversion program 

SYNOPSIS 

units 

DESCRIPTION 

Units converts quantities expressed in various standard scales to their equivalents in other scales. It works 
interactively in this fashion: 

You have: inch 
You want: cm 

= 1 ^ 2.540000e+00 
/ 3.937008e-01 

A quantity is specified as a multiplicative combination of units optionally preceded by a numeric multiplier. 
Powers are indicated by suffixed positive integers, division by the usual sign: 

You have: 15 lbs force/in2 
You want: atm 

= 1 ^ 1.020689e+00 
/ 9.797299e-01 

Units only does multiplicative scale changes; thus it can convert Kelvin to Rankine, but not Centigrade to 
Fahrenheit. Most familiar units, abbreviations, and metric prefixes are recognized, together with a generous 
leavening of exotica and a few constants of nature including: 
pi ratio of circumference to diameter, 
c speed of light, 
e charge on an electron, 
g acceleration of gravity, 
force same as g, 
mole Avogadro’s number, 
water pressure head per unit height of water, 
au astronomical unit. 

Pound is not recognized as a unit of mass; lb is. Compound names are run together, (e.g. ligbtyear). Brit¬ 
ish units that differ from their U.S. counterparts are prefixed thus: brgallon. For a complete list of units, 
type: 

cat /usr/lib/unittab 


FILES 


/usr/lib/unittab 
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NAME 

uuclean - uucp spool directory clean-up 

SYNOPSIS 

uuclean [ options ] ... 

DESCRIPTION 

Uuclean will scan the spool directory for files with the specified prefix and delete all those which are older 
than the specified number of hours. 

The following options are available. 

—^directory 

Clean directory instead of the spool directory. 

-ppre Scan for files with pre as the file prefix. Up to 10 -p arguments may be specified. A -p without 
any pre following will cause all files older than the specified time to be deleted. 

-ntime Files whose age is more than time hours will be deleted if the prefix test is satisfied, (default time 
is 72 hours) 

-m Send mail to the owner of the file when it is deleted. 

This program will typically be started by cro«(lM). 

FILES 

/usr/lib/uucp directory with commands used by uuclean internally 

/usr/spool/uucp spool directory 

SEE ALSO 

uucp(lC), uux(lC). 
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NAME 

uucp, uulog, uuname - unix to unix copy 
SYNOPSIS 

uucp [ option ] ... source-file ... destination-file 
uulog [ option ] ... 
uuname 
DESCRIPTION 

Uucp copies files named by the source-file arguments to the destination-file argument. A file name may be 
a path name on your machine, or may have the form: 

system-name!path-name 

where system-name is taken from a list of system names which uucp knows about. Shell metacharacters 
?*[] appearing in path-name will be expanded on the appropriate system. 

Path names may be one of: 

(1) a full path name; 

(2) a path name preceded by "user where user is a login name on the specified system and is replaced 
by that user’s login directory; 

(3) a path name preceded by "luser where user is a login name on the specified system and is replaced 
by that user’s directory under PUBDIR; 

(4) anything else is prefixed by the current directory. 

If the result is an erroneous path name for the remote system the copy will fail. If the destination-file is a 
directory, the last part of the source-file name is used. 

Uucp preserves execute permissions across the transmission and gives 0666 read and write permissions 
(see chmod{2)). 

The following options are interpreted by uucp: 

-d Make all necessary directories for the file copy (default). 

-f Do not make intermediate directories for the file copy. 

-c Use the source file when copying out rather than copying the file to the spool directory (default). 

-C Copy the source file to the spool directory. 

-m Send mail to the requester when the copy is complete. 

-nuser Notify user on the remote system that a file was sent. 

Send the uucp command to system sys to be executed there. (Note - this will only be successful if 
the remote machine allows the uucp command to be executed by /usr/Iib/uucp/uuxqt.) 

Uulog maintains a summary log of uucp and uux(\C) transactions in the file /usr/spool/uucp/LOGFILE by 
gathering information from partial log files named /usr/spool/uucp/LOG.*.?. (These files will only be cre¬ 
ated if the LOGFILE is being used by another process.) It removes the partial log files. 

The options cause uulog to print logging information: 

-s.vyi' Print information about work involving system sys. 

-uuser Print information about work done for the specified user. 

Uuname lists the uucp names of known systems. The -1 option returns the local system name. 

FILES 

/usr/spool/uucp spool directory 

/usr/spool/uucppublic public directory for receiving and sending (PUBDIR) 
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/usr/lib/uucp/* other data and program files 

SEE ALSO 

mail(l), uux(lC). 

Uucp Implementation Description by D. A. Nowitz. 

WARNING 

The domain of remotely accessible files can (and for obvious security reasons, usually should) be severely 
restricted. You will very likely not be able to fetch files by path name; ask a responsible person on the 
remote system to send them to you. For the same reasons you will probably not be able to send files to 
arbitrary path names. As distributed, the remotely accessible files are those whose names begin 
/usr/spool/uucppublic (equivalent to "nuucp or just 

BUGS 

All files received by uucp will be owned by uucp. 

The -m option will only work sending files or receiving a single file. (Receiving multiple files specified by 
special shell characters ?*[] will not activate the -m option.) 
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NAME 

uustat - uucp status inquiry and job control 

SYNOPSIS 

uustat [ option ] ... 

DESCRIPTION 

Uustat will display the status of, or cancel, previously specified uucp commands, or provide general status 
on uucp connections to other systems. The following options are recognized: 

-mmch Report the status of accessibility of machine mch. If mch is specified as all, then the status of 
all machines known to the local uucp are provided. 

-^john Kill the uucp request whose job number is jobn. The killed uucp request must belong to the 
person issuing the uustat command unless he is the super-user. 

-chour Remove the status entries which are older than hour hours. This administrative option can 
only be initiated by the user uucp or the super-user. 

-uuser Report the status of all uucp requests issued by user. 

-s^yi' Report the status of all uucp requests which communicate with remote system sys. 

-ohour Report the status of all uucp requests which are older than hour hours. 

-yhour Report the status of all uucp requests which are younger than hour hours. 

-iall Report the status of all the uucp requests. 

-V Report the uucp status verbosely. If this option is not specified, a status code is printed with 

each uucp request. 

When no options are given, uustat outputs the status of all uucp requests issued by the current user. Note 
that only one of the options -j, -m, -k, -c, or the rest of other options may be specified. 

For example, the command 

uustat -uhdc -smhtsa -y72 -v 

will print the verbose status of all uucp requests that were issued by user hdc to communicate with system 
mhtsa within the last 72 hours. The meanings of the job request status are: 

job-number user remote-system command-time status-time status 

where the status may be either an octal number or a verbose description. The octal code corresponds to the 
following description: 

OCTAL STATUS 

00001 the copy failed, but the reason cannot be determined 

00002 permission to access local file is denied 

00004 permission to access remote file is denied 

00010 bad uucp command is generated 

00020 remote system cannot create temporary file 

00040 cannot copy to remote directory 

00100 cannot copy to local directory 

00200 local system cannot create temporary file 

00400 cannot execute uucp 

01000 copy succeeded 

02000 copy finished, job deleted 

04000 job is queued 


The meanings of the machine accessibility status are: 
system-name time status 

where time is the latest status time and status is a self-explanatory description of the machine status. 


FILES 
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/usr/spool/uucp spool directory 

/usr/lib/uucp/L_stat system status file 

/usr/lib/uucp/R_stat request status file 

SEE ALSO 

uucp(lC). 

Uustat- A UUCP Status Inquiry Program, by H. Che. 
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NAME 

uusub - monitor uucp network 

SYNOPSIS 

uusub [ options ] 

DESCRIPTION 

Uusub defines a uucp subnetwork and monitors the connection and traffic among the members of the sub¬ 
network. The following options are available: 

Add sys to the subnetwork. 

-d.9y5' Delete sys from the subnetwork. 

-I Report the statistics on connections. 

-r Report the statistics on traffic amount. 

-f Flush the connection statistics. 

-uhr Gather the traffic statistics over the past hr hours. 

Exercise the connection to the system sys. If .yy^ is specified as all, then exercise the connection 
to all the systems in the subnetwork. 

The meanings of the connections report are: 

sys #call #ok time #dev #login #nack #other 

where sys is the remote system name, #call is the number of times the local system tries to call sys since 
the last flush was done, #ok is the number of successful connections, time is the the latest successful con¬ 
nect time, Mev is the number of unsuccessful connections because of no available device (e.g. ACU), 
Mogin is the number of unsuccessful connections because of login failure, ihiack is the number of unsuc¬ 
cessful connections because of no response (e.g. line busy, system down), and Mother is the number of 
unsuccessful connections because of other reasons. 

The meanings of the traffic statistics are: 
sfile sbyte rfile rbyte 

where sfile is the number of files sent and sbyte is the number of bytes sent over the period of time indicated 
in the latest uusub command with the -uhr option. Similarly, rfile and rbyte are the numbers of files and 
bytes received. 

The command: 

uusub -c all -u 24 

is typically started by cron(IM) once a day. 

FILES 

/usr/spool/uucp/SYSLOG system log file 

/usr/lib/uucp/L_sub connection statistics 

/usr/lib/uucp/R_sub traffic statistics 

SEE ALSO 

uucp(lC), uustat(lC). 
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NAME 

uuto, uupick - public UNIX-to-UNIX file copy 
SYNOPSIS 

uuto [ options ] source-files destination 
uupick [ -s system ] 

DESCRIPTION 

Uuto sends source-files to destination. Uuto uses the uucp(\C) facility to send files, while it allows the 
local system to control the file access. A source-file name is a path name on your machine. Destination has 
the form: 

system!M.9er 

where system is taken from a list of system names that uucp knows about (see uuname{\C)). Logname is 
the login name of someone on the specified system. 

Two options are available: 

-p Copy the source file into the spool directory before transmission. 

-m Send mail to the sender when the copy is complete. 

The files (or sub-trees if directories are specified) are sent to PUB DIR on system, where PUBDIR is a public 
directory defined in the uucp source. Specifically the files are sent to 

PUBDIR/receive/Mi'^r/my^y.s'tem/files. 

The destined recipient is notified by mail(l) of the arrival of files. 

Uupick accepts or rejects the files transmitted to the user. Specifically, uupick searches PUBDIR for files 
destined for the user. For each entry (file or directory) found, the following message is printed on the stan¬ 
dard output: 

from {filefile-name'\ {d\x dirname^ ? 

Uupick then reads a line from the standard input to determine the disposition of the file: 

<new-line> Go on to next entry, 

d Delete the entry. 

m [ dir ] Move the entry to named directory dir (current directory is default), 

a [ dir ] Same as m except moving all the files sent from system. 

p Print the content of the file, 

q Stop. 

EOT (control-d) Same as q. 

[command Escape to the shell to do command. 

* Print a command summary. 

Uupick invoked with the -ssystem option will only search the PUBDIR for files sent from system. 

FILES 

PUBDIR /usr/spool/uucppublic public directory 
SEE ALSO 

mail(l), uuclean(lM), uucp(lC), uulog(lC), uuname(lC), uustat(lC), uux(lC). 
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NAME 

uux - Unix to Unix command execution 
SYNOPSIS 

uux [ - ] command-string 
DESCRIPTION 

Uux will gather zero or more files from various systems, execute a command on a specified system and then 
send standard output to a file on a specified system. Note that, for security reasons, many installations will 
limit the list of commands executable on behalf of an incoming request from uux. Many sites will permit 
little more than the receipt of mail (see mail{\.)) via uux. 

The command-string is made up of one or more arguments that look like a Shell command line, except that 
the command and file names may be prefixed by system-namel. A null system-name is interpreted as the 
local system. 

File names may be one of 

(1) a full path name; 

(2) a path name preceded by "xxx where xxx is a login name on the specified system and is 
replaced by that user’s login directory; 

(3) anything else is prefixed by the current directory. 

The - option will cause the standard input to the uux command to be the standard input to the command¬ 
string. For example, the command 

uux " !diff usg!/usr/dan/fl pwba!/a4/dan/fl > Ifl.diff" 

will get the fl files from the “usg” and “pwba” machines, execute a dijf command and put the results in 
fl.diff in the local directory. 

Any special shell characters such as <>; I should be quoted either by quoting the entire command-string, or 
quoting the special characters as individual arguments. 

Uux will attempt to get all files to the execution system. For files which are output files, the file name must 
be escaped using parentheses. For example, the command 

uux a!uucp b!/usr/file \(c!/usr/file\) 

will send a uucp command to system “a” to get /usr/file from system “b” and send it to system “c”. 

Uux will notify you if the requested command on the remote system was disallowed. The response comes 
by remote mail from the remote machine. 

FILES 

/usr/lib/uucp/spool spool directory 

/usr/lib/uucp/* other data and programs 

SEE ALSO 

uuclean(lM), uucp(lC). 

Uucp Implementation Description by D. A. Nowitz 

BUGS 

Only the first command of a shell pipeline may have a system-namel. All other commands are executed on 
the system of the first command. 

The use of the shell metacharacter * will probably not do what you want it to do. The shell tokens « and 
» are not implemented. 
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NAME 

val - validate SCCS file 

SYNOPSIS 

val - 

val [-s] [-rSID] [-mname] [-ytype] files 
DESCRIPTION 

Val determines if the specifiedis an SCCS file meeting the characteristics specified by the optional argu¬ 
ment list. Arguments to val may appear in any order. The arguments consist of keyletter arguments, which 
begin with a and named files. 

Val has a special argument, which causes reading of the standard input until an end-of-file condition is 
detected. Each line read is independently processed as if it were a command line argument list. 

Val generates diagnostic messages on the standard output for each command line and file processed and 
also returns a single 8-bit code upon exit as described below. 

The keyletter arguments are defined as follows. The effects of any keyletter argument apply independently 
to each named file on the command line. 

-s The presence of this argument silences the diagnostic message normally generated 

on the standard output for any error that is detected while processing each named 
file on a given command line. 

-rSlD The argument value SID (SCCS /Dentification String) is an SCCS delta number. A 

check is made to determine if the SID is ambiguous (e. g., rl is ambiguous because 
it physically does not exist but implies 1.1, 1.2, etc. which may exist) or invalid (e. 
g., rl.O or rl.1.0 are invalid because neither case can exist as a valid delta num¬ 
ber). If the SID is valid and not ambiguous, a check is made to determine if it actu¬ 
ally exists. 

-mname The argument value name is compared with the SCCS %M% keyword in file, 

-ytype The argument value type is compared with the SCCS %Y% keyword in file. 

The 8-bit code returned by val is a disjunction of the possible errors, i. e., can be interpreted as a bit string 
where (moving from left to right) set bits are interpreted as follows: 

bit 0 = missing file argument; 

bit 1 = unknown or duplicate keyletter argument; 

bit 2 = corrupted SCCS file; 

bit 3 = can’t open file or file not SCCS; 

bit 4 = SID is invalid or ambiguous; 

bit 5 = SID does not exist; 

bit 6 = %Y%, -y mismatch; 

bit 7 = %M%, -m mismatch; 

Note that val can process two or more files on a given command line and in turn can process multiple com¬ 
mand lines (when reading the standard input). In these cases an aggregate code is returned - a logical OR 
of the codes generated for each command line and file processed. 

SEE ALSO 

admin(l), delta(l), get(l), prs(l). 

DIAGNOSTICS 

Use help{l) for explanations. 

BUGS 

Val can process up to 50 files on a single command line. Any number above 50 will produce a core dump. 
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NAME 

VC - version control 
SYNOPSIS 

VC [-a] [-t] [-cchar] [-s] [keyword=value ... keyword=value] 

DESCRIPTION 

The VC command copies lines from the standard input to the standard output under control of its arguments 
and control statements encountered in the standard input. In the process of performing the copy operation, 
user declared keywords may be replaced by their string value when they appear in plain text and/or control 
statements. 

The copying of lines from the standard input to the standard output is conditional, based on tests (in control 
statements) of keyword values specified in control statements or as vc command arguments. 

A control statement is a single line beginning with a control character, except as modified by the -t keylet- 
ter (see below). The default control character is colon (:), except as modified by the -c keyletter (see 
below). Input lines beginning with a backslash (\) followed by a control character are not control lines and 
are copied to the standard output with the backslash removed. Lines beginning with a backslash followed 
by a non-control character are copied in their entirety. 

A keyword is composed of 9 or less alphanumerics; the first must be alphabetic. A value is any ASCII 
string that can be created with ed{\)\ a numeric value is an unsigned string of digits. Keyword values may 
not contain blanks or tabs. 

Replacement of keywords by values is done whenever a keyword surrounded by control characters is 
encountered on a version control statement. The -a keyletter (see below) forces replacement of keywords 
in all lines of text. An uninterpreted control character may be included in a value by preceding it with V If 
a literal \ is desired, then it too must be preceded by V 

Keyletter arguments 

-a Forces replacement of keywords surrounded by control characters with their 

assigned value in all text lines and not just in vc statements. 

-t All characters from the beginning of a line up to and including the first tab charac¬ 

ter are ignored for the purpose of detecting a control statement. If one is found, all 
characters up to and including the tab are discarded. 

-cchar Specifies a control character to be used in place of :. 

-s Silences warning messages (not error) that are normally printed on the diagnostic 

output. 

Version Control Statements 

:dcl keyword[,..., keyword] 

Used to declare keywords. All keywords must be declared. 

:asg keyword=value 

Used to assign values to keywords. An asg statement overrides the assignment for the corresponding 
keyword on the vc command line and all previous asg’s for that keyword. Keywords declared, but 
not assigned values have null values. 

:if condition 


:end 

Used to skip lines of the standard input. If the condition is true all lines between the if statement and 
the matching end statement are copied to the standard output. If the condition is false, all intervening 
lines are discarded, including control statements. Note that intervening if statements and matching 
end statements are recognized solely for the purpose of maintaining the proper if-end matching. 
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The syntax of a condition is: 


<cond> 

<or> 

<and> 

<exp> 

<op> 

<value> 


[ "not" ] <or> 

<and> I <and> "|" <or> 

<exp> I <exp> <and> 

"(" <or> ")" I <value> <op> <value> 

<arbitrary ASCII string> | <numeric string> 


The available operators and their meanings are: 

= equal 

!= not equal 

& and 


() 

not 


greater than 
less than 

used for logical groupings 
may only occur immediately after the if, and 
when present, inverts the value of the 
entire condition 


The > and < operate only on unsigned integer values (e. g.: 012 > 12 is false). All other operators 
take strings as arguments (e. g.: 012 != 12 is true). The precedence of the operators (from highest to 
lowest) is: 

= != >< all of equal precedence 
& 

I 

Parentheses may be used to alter the order of precedence. 

Values must be separated from operators or parentheses by at least one blank or tab. 


Used for keyword replacement on lines that are copied to the standard output. The two leading con¬ 
trol characters are removed, and keywords surrounded by control characters in text are replaced by 
their value before the line is copied to the output file. This action is independent of the -a keyletter. 

:on 

:off 

Turn on or off keyword replacement on all lines. 

:ctl char 

Change the control character to char. 

:msg message 

Prints the given message on the diagnostic output. 

:err message 

Prints the given message followed by: 

ERROR: err statement on line ... (915) 
on the diagnostic output. Vc halts execution, and returns an exit code of 1. 

DIAGNOSTICS 

Use help{\) for explanations. 

EXIT CODES 

0 - normal 
1 - any error 
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NAME 

vlx - VAX-11/780 LSI console floppy interface 

SYNOPSIS 

vlx key [ files ] 

DESCRIPTION 

Vlx is used to maintain the console floppy. The floppy is in DEC RT-11 format. Hence, a. file name is 
restricted to a 1 - to 6-character alphanumeric name optionally followed by a . character separator and a 1 - to 
3-character alphanumeric extension. Upper and lower cases are mapped together. Only the last component 
of a path name is used. 

Key is one character from the set drtx, optionally concatenated with one or both of vf. The meanings of the 
key characters are: 

d Delete the named files from the floppy, 
r Replace the named files on the floppy. 

t Print a table of contents of the floppy. If no names are given, all files are tabled. If names are given, 
only those files are tabled. 

X Extract the named files from the floppy. If no names are given, all files are extracted. 

V Verbose. When used with t, it gives a long listing of all information about the files. When used with 
X, it precedes each file with a name. 

f Use the next name as the floppy file name, instead of the default /dev/conflp. 

FILES 

/dev/conflp console floppy 

SEE ALSO 

vaxops(8). 

BUGS 

Dependent on knowledge and correctness of DEC software. 
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NAME 

volcopy, labelit - copy file systems with label checking 
SYNOPSIS 

/etc/volcopy [-bpibits-per-inch ] [-feetsize ] fsname special 1 volnamel special2 volnamel 

/etc/labelit special [ fsname volume [ -n ] ] 

DESCRIPTION 

Volcopy makes a literal copy of the file system using a blocksize matched to the device (10 blocks for 
800/1600 bpi tape; 88 blocks for everything else). Using volcopy, a 2400 foot/1600 bpi tape will hold a 
65K file system. The optional flag arguments are used only with tapes (-bpi — bits-per-inch; -feet — size 
of reel in feet). The program requests the information if it is not given on the command line. If the file sys¬ 
tem is too large to fit on one reel, volcopy will prompt for additional reels. Labels of all reels are checked. 
Tapes may be mounted alternately on two drives. 

The fsname argument represents the mounted name (e.g.: root, ul, etc.) of the filsystem being copied. 

The special should be the physical disk section or tape (e.g.: /dev/rrplS, /dev/rmtO, etc.). 

The volname is the physical volume name (e.g.: pk3, t0122, etc.) and should match the external label 
sticker. Such label names are limited to five or fewer characters. 

Speciall and volnamel are the device and volume from which the copy of the file system is being 
extracted. Speciall and volnamel are the target device and volume. 

Fsname and volname are recorded in the last 12 characters of the superblock (char fsname[6], vol- 
name[6];). 

Labelit can be used to provide initial labels for unmounted disk or tape file systems. With the optional 
arguments omitted, labelit prints current label values. The -n option provides for initial labeling of new 
tapes only (this destroys previous contents). 

FILES 

/etc/log/filesave a record of file systems/volumes copied 

SEE ALSO 

fs(5). 

BUGS 

Only device names beginning /dev/rmt are treated as tapes. 
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NAME 

vpmc - compiler for the virtual protocol machine 
SYNOPSIS 

vpmc [ -m ] [ -r ] [ -c ] [ -X ] [ -s sfile ] [ -1 Ifile ] [ -i ifile ] [ -o ofile ] file 
DESCRIPTION 

Vpmc is the compiler for a language that is used to describe communications link protocols. The output of 
vpmc is a load module for the virtual protocol machine (VPM), which is a software construct for imple¬ 
menting communications link protocols (e.g., BISYNC) on the DEC KMCl 1 microprocessor. VPM is imple¬ 
mented by an interpreter in the KMCl 1 which cooperates with a driver in the UNIX host computer to trans¬ 
fer data over a communications link in accordance with a specified link protocol. UNIX user processes 
transfer data to or from a remote terminal or computer system through VPM using normal UNIX open, read, 
write, and close operations. The VPM program in the KMCl 1 provides error control and flow control using 
the conventions specified in the protocol. 

The language accepted by vpmc is essentially a subset of C; the implementation of vpmc uses the RATFOR 
preprocessor (ratforil)) as a front end; this leads to a few minor differences, mostly syntactic. 

There are two versions of the interpreter. The appropriate version for a particular application is selected by 
means of the -i option. The BISYNC version (-i bisync) supports half-duplex, character-oriented protocols 
such as the various forms of BISYNC. The HDLC version (-i hdlc) supports full-duplex, bit-oriented proto¬ 
cols such as HDLC. The communications primitives used with the BISYNC version are character-oriented 
and blocking; the primitives used with the HDLC version are frame-oriented and non-blocking. 

Options 

The meanings of the command-line options are: 

-m Use m4{l) instead of cpp as the macro preprocessor. 

-r Produce RATFOR output on the standard output and suppress the remaining compiler phases. 

-c Compile only (suppress the assembly and linking phases). 

-X Retain the intermediate files used for communication between passes. 

-s sfile Save the generated VPM assembly language on file sfile. 

-I Ifile Produce a VPM assembly-language listing on file Ifile. 

-i ifile Use the interpreter version specified by ifile (default bisync). 

-o ofile Write the executable object file on file ofile (default a.out). 

These options may be given in any order. 

Programs 

Input to vpmc consists of a (possibly null) sequence of array declarations, followed by one or more function 
definitions. The first defined function is invoked (on command from the UNIX VPM driver) to begin pro¬ 
gram execution. 

Functions 

A function definition has the following form: 

function name{) 
statement_list 
end 

Function arguments (formal parameters) are not allowed. The effect of a function call with arguments can 
be obtained by invoking the function via a macro that first assigns the value of each argument to a global 
variable reserved for that purpose. See EXAMPLES below. 

A statement_list is a (possibly null) sequence of labeled statements. A labeled_statement is a statement 
preceded by a (possibly null) sequence of labels. A label is either a name followed by a colon (:) or a deci¬ 
mal integer optionally followed by a colon. 

The statements that make up a statement list must be separated by semicolons (;). (A semicolon at the end 
of a line can usually be omitted; refer to the description of RATFOR for details.) Null statements are 
allowed. 

Statement Syntax 

The following types of statements are allowed: 

expression 
lvalue-expression 
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lvalue+-expression 

lvalue--expression 

lvalue I —expression 

lvalue &-expression 

Ivalue'^-expression 

lvalue<s:=expression 

lvalue:s>=expression 

ii{expression )statement 

ii{expression)statement else statement 

'whi\e{expression)statement 

foT(statement; expression', statement)statement 

repeat statement 

repeat statement until expression 

break 

next 

switchiexpression ) { casejist } 
rt\Mvn{expression ) 
return 
goto name 

goto decimal_constant 
{ statement_list ] 

repeat is equivalent to the do keyword in C; next is equivalent to continue. 

A casejist is a sequence of statement lists, each of which is preceded by a label of the form: 
case constant: 

The label for the last statementJist in a casejist may be of the form: 
default: 

Unlike C, RATFOR supplies an automatic break preceding each new case label. 

Expression Syntax 

A primary_expression (abbreviated primary) is an lvalue or a constant. An lvalue is one of the following: 
name 

name [constant] 

A unary_expression (abbreviated unary) is one of the following: 

primary 

name{) 

system_call 

++lvalue 

—lvalue 

(expression) 

\ unary 
~unary 

The following types of expressions are allowed: 
unary 

unary+primary 
unary-primary 
unary {primary 
unary &primary 
unary &rprimary 
unary''primary 
unary "^primary 
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unary:s>pnmary 

unary==primary 

unary \-primary 

unary>primary 

unary<primary 

unary>=primary 

unary <-primary 

Note that the right operand of a binary operator can only be a constant, a name, or a name with a constant 
subscript. 

System Calls 

A VPM program interacts with a communications device and a driver in the host computer by means of sys¬ 
tem calls (primitives). 

The following primitives are available only in the BISYNC version of the interpreter: 
rimary) 

The value of the primary expression is combined with the cyclic redundancy check-sum at the 
location passed by a previous crcloc system call. The CRC-16 polynomial @(x sup 16 + x sup 15 
-I- X sup 2 + 1)@ is used for the check-sum calculation. 

crcXociname) 

The two-byte array starting at the location specified by name is cleared. The address of the array 
is recorded as the location to be updated by subsequent crcl6 system calls. 

get(/vn/n^) 

Get a byte from the current transmit buffer. The next available byte, if any, is copied into the 
location specified by lvalue. The returned value is zero if a byte was obtained, otherwise it is 
non-zero. 

getrbuf(«i7me) 

Get (open) a receive buffer. The returned value is zero if a buffer is available, otherwise it is non¬ 
zero. If a buffer is obtained, the buffer parameters are copied into the array specified by name. 
The array should be large enough to hold at least three bytes. The meaning of the buffer parame¬ 
ters is driver-dependent. If a receive buffer has previously been opened via a getrbuf call but has 
not yet been closed via a call to rtnrbuf, that buffer is reinitialized and remains the current buffer. 

getxhufiname) 

Get (open) a transmit buffer. The returned value is zero if a buffer is available, otherwise it is 
non-zero. If a buffer is obtained, the buffer parameters are copied into the array specified by 
name. The array should be large enough to hold at least three bytes. The meaning of the buffer 
parameters is driver-dependent. If a transmit buffer has previously been opened via a getxbuf call 
but has not yet been closed via a call to rtnxbuf, that buffer is reinitialized and remains the current 
buffer. 

^uiiprimary) 

Put a byte into the current receive buffer. The value of the primary expression is inserted into the 
next available position, if any, in the current receive buffer. The returned value is zero if a byte 
was transferred, otherwise it is non-zero. 

vc\{lvalue) 

Receive a character. The process delays until a character is available in the input silo. The charac¬ 
ter is then moved to the location specified by lvalue and the process is reactivated. 

rsom{constant) 

Skip to the beginning of a new receive frame. The receiver hardware is cleared and the value of 
constant is stored as the receive sync character. This call is used to synchronize the local receiver 
and remote transmitter when the process is ready to accept a new receive frame. 
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rtnrhuf{name) 

Return a receive buffer. The original values of the buffer parameters for the current receive buffer 
are replaced with values from the array specified by name. The current receive buffer is then 
released to the driver. 

rtnxbuf(«am^) 

Return a transmit buffer. The 
buffer are replaced with values 
then released to the driver. 

\eom{constant) 

Transmit end-of-message. The value of the constant is transmitted, then the transmitter is shut 
down. 

\mt(primary) 

Transmit a character. The value of the primary expression is transmitted over the communications 
line. If the output silo is full, the process waits until there is room in the silo. 

\som(constant) 

Transmit start-of-message. The transmitter is cleared, then the value of constant is transmitted six 
times. This call is used to synchronize the local transmitter and the remote receiver at the begin¬ 
ning of a frame. 

The following primitives are available only with the HDLC version of the interpreter: 
abtxfrmO 

The current transmission, if any, is aborted, if possible, by sending a frame-abort sequence (seven 
one bits, followed immediately by a terminating flag). This operation is not feasible with some 
hardware interfaces, in which case this primitive is a no-operation. 

getidrmiprimary) 

Get a transmit buffer. If the transmit-buffer queue is not empty, the buffer at the head of the queue 
is removed from the queue and attached to the sequence number specified by the value of the 
primary expression. If the sequence number is greater than seven or the sequence number already 
has a buffer attached, the process is terminated in error. The returned value is zero if a buffer was 
obtained, otherwise non-zero. 

rcvfrin(niim^) 

Get a completed receive frame. If the queue of completed receive frames is non-empty, the frame 
at the head of the queue is removed and becomes the current receive frame. If a frame is obtained, 
the first five bytes of the frame are copied into the array specified by name. The returned value is 
true (non-zero) if a frame was obtained; otherwise, it is false (zero). The rightmost four bits of the 
returned value indicate the frame length as follows: if the value of the rightmost four bits is equal 
to fifteen, the frame length is greater than or equal to 15; otherwise the frame length is equal to the 
value of the rightmost four bits. The frame length includes the two CRC bytes at the end of the 
frame and any control information at the beginning of the frame. Bytes following the first two 
bytes of the frame, but not including the two CRC bytes, are copied into a receive buffer, if one is 
available at the time the frame is received. Bit 020 of the returned value is zero if a receive buffer 
was available, otherwise non-zero. The values of the leftmost three bits of the returned value are 
currently unspecified. If a frame was obtained, the first five bytes of the frame are copied into the 
array specified by name. Frames with errors are discarded; a count is kept for each type of error. 
Frames may be discarded for any of the following reasons: (1) CRC error, (2) frame too short (less 
than four bytes), (3) frame too long (buffer size exceeded), or (4) no receive buffer available. If a 
frame with a buffer attached was previously obtained with rcvfrm, but the buffer has not been 
released to the driver with rtnrfrm, that buffer is returned to the queue of empty receive buffers. 
At most one receive frame with no buffer attached is retained by the interpreter; if a new frame 
arrives before the frame with no buffer attached has been obtained with rcvfrm, the new frame is 
discarded. 


original values of the buffer parameters for the current transmit 
from the array specified by name. The current transmit buffer is 
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rtnrfrm() 

Return a receive buffer. The current receive buffer (the one obtained by the most recent rcvfrm 
primitive) is returned to the driver. If there is no current receive buffer, the process is terminated 
in error. 

rsxmtq() 

Reset the transmit-buffer queue. The sequence number assignment is removed from all transmit 
buffers. If a transmission is currently in progress, the transmission is aborted, if possible. 

rtn\frm(p rimary) 

Return a transmit buffer. The transmit buffer currently attached to the sequence number specified 
by the value of the primary is returned to the driver and the sequence number assignment is 
removed from that buffer. If the specified sequence number does not have a buffer attached, the 
process is terminated in error. Transmit buffers must be returned in the same sequence in which 
they were obtained, otherwise the process is terminated in error. 

setct\(name^primary) 

Specify transmit-control information. The number of bytes specified by the primary are copied 
from the array specified by name and saved for use with subsequent xmtfrm or xmtcti primitives. 
If the transmitter is currently busy, the process is terminated in error. 

xmtbusy() 

Test for transmitter busy. If a frame is currently being transmitted, the returned value is true 
(non-zero); otherwise the returned value is false (zero). 

xmtctIO 

Transmit a control frame. If a transmission is not already in progress, a new transmission is initi¬ 
ated. The transmitted frame will contain the control information specified by the most recent 
setctl primitive, followed by a two-byte CRC. The CRC-CCITT polynomial @(x sup 16 + x sup 12 
-I- X sup 5 + 1)@ is used for the CRC calculation. The returned value is zero if a new transmission 
was initiated, otherwise non-zero. 

\mtfrm(p rimary) 

Transmit an information frame. If a transmission is not already in progress, a new transmission is 
initiated. The transmitted frame will contain the control information specified by the most recent 
setctl primitive, followed by the contents of the buffer which is currently attached to the sequence 
number specified by the value of the primary expression, followed by a two-byte CRC. The CRC- 
CCITT polynomial @(x sup 16 + x sup 12 -i- x sup 5 + 1)@ is used for the CRC calculation. The 
returned value is zero if a new transmission was initiated, otherwise non-zero. If the sequence 
number is greater than seven or the sequence number does not have a buffer attached, the process 
is terminated in error. 

The following primitives are available with all versions of the interpreter: 

dsrwait() 

Wait for modem-ready and then set modem-ready mode. The process delays until the modem- 
ready signal from the modem interface is asserted. If the modem-ready signal subsequently drops, 
the process is terminated. If dsrwait is never invoked, the modem-ready signal is ignored. 

exitiprimary) 

Terminate execution. The process is halted and the value of the primary expression is passed to 
the driver. 

getcmd(name) 

Get a command from the driver. If a command has been received from the driver since the last 
call to getcmd, four bytes of command information are copied into the array specified by name 
and a value of true (non-zero) is returned. If no command is available, the returned value is false 
(zero). 
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pause() Return control to the dispatcher. This primitive informs the dispatcher that the virtual process may 
be suspended until the next occurrence of an event that might affect the state of the protocol for 
this line. Examples of such events are: (1) completion of an output transfer, (2) completion of an 
input transfer, (3) timer expiration, and (4) a buffer-in command from the driver. In a multi-line 
implementation, the pause primitive allows the process for a given line to give up control to allow 
the processor to service another line. 

rtnrpt(nawe) 

Return a report to the driver. Four bytes from the array specified by name are transferred to the 
driver. The process delays until the transfer is complete. 

testop(pWmiiAy’) 

Test for odd parity. The returned value is true (non-zero) if the value of the primary expression 
has odd parity, otherwise the returned value is false (zero). 

t\meout(primary) 

Schedule or cancel a timer interrupt. If the value of the primary expression is non-zero, the cur¬ 
rent values of the program counter and stack pointer are saved and a timer is loaded with the value 
of primary. The system call then returns immediately with a value of false (zero) as the returned 
value. The timer is decremented each tenth of a second thereafter. If the timer is decremented to 
zero, the saved values of the program counter and stack pointer are restored and the system call 
returns with a value of true (non-zero). The effect of the timer interrupt is to return control to the 
code immediately following the timeout system call, at which point a non-zero return value indi¬ 
cates that the timer has expired. The timeout system call with a non-zero argument is normally 
written as the condition part of an if statement. A timeout system call with a zero argument value 
cancels all previous timeout requests, as does a return from the function in which the timeout 
system call was made. A timeout system call with a non-zero argument value overrides all previ¬ 
ous timeout requests. The maximum permissible value for the argument is 255, which gives a 
timeout period of 25.5 seconds. 

ixm^riprimary) 

Start a timer or test for timer expiration. If the value of the primary is non-zero, a software timer 
is loaded with the value of the primary and a value of true (non-zero) is returned. The timer is 
decremented each tenth of a second thereafter until it reaches zero. If the value of the primary is 
zero, the returned value is the current value of the timer; this will be true (non-zero) if the value of 
the timer is currently non-zero, otherwise false (zero). The timer used by this primitive is different 
from the timer used by the timeout primitive. 

trace(primary[,primary]) 

The values of the two primary expressions and the current value of the script location counter are 
passed to the driver. If the second primary is omitted, a zero is used instead. The process delays 
until the values have been accepted by the host computer. 

Constants 

A constant is a decimal, octal, or hexadecimal integer, or a single character enclosed in single quotes. A 
token consisting of a string of digits is taken to be an octal integer if the first digit is a zero, otherwise the 
string is interpreted as a decimal integer. If a token begins with Ox or OX, the remainder of the token is 
interpreted as a hexadecimal integer. The hexadecimal digits include a through f or, equivalently, A 
through F. 

Variables 

Variable names may be used without having been previously declared. All names are global. All values 
are treated as 8-bit unsigned integers. 

Arrays of contiguous storage may be allocated using the array declaration: 
array name\constant\ 
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where constant is a decimal integer. Elements of arrays can be referenced using constant subscripts: 
name {constant'\ 

Indexing of arrays assumes that the first element has an index of zero. 

Names 

A name is a sequence of letters and digits; the first character must be a letter. Upper- and lower-case letters 
are considered to be distinct. Names longer than 31 characters are truncated to 31 characters. The under¬ 
score (_) may be used within a name to improve readability, but is discarded by RATFOR. 

Preprocessor Commands 

If the -m option is omitted, comments, macro definitions, and file inclusion statements are written as in C. 
Otherwise, the following rules apply: 

1. If the character # appears in an input line, the remainder of the line is treated as a comment. 

2. A statement of the form: 

AefiRe{name ,text) 

causes every subsequent appearance of name to be replaced by text. The defining text includes every¬ 
thing after the comma up to the balancing right parenthesis; multi-line definitions are allowed. Macros 
may have arguments. Any occurrence of $n within the replacement text for a macro will be replaced 
by the nth actual argument when the macro is invoked. 

3. A statement of the form: 

include(/7/e) 

inserts the contents of file in place of the include command. The contents of the included file is often 
a set of definitions. 

EXAMPLES 

These examples require the use of the -m option. 

# The function defined below transmits a frame in transparent BISYNC. 

# A transmit buffer must be obtained with getxbuf before the function 

# is invoked. 

# 

# Define symbolic constants: 

# 

define(DLE,OxlO) 

define(ETB,0x26) 

define(PAD,Oxff) 

define(STX,0x02) 

define(SYNC,0x32) 

# 

# Define a macro with an argument: 

# 

define(xmtcrc, {crc 16($ 1); xmt($ 1);}) 

# 

# Declare an array: 

# 

array crc [2]; 

# 

# Define the function: 

# 

function xmtblk() 
crcloc(crc); 
xsom(SYNC); 
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xmt(DLE); 

xmt(STX); 

while(get(byte)==0) { 

if(byte == DLE) 

xmt(DLE); 

xmtcrc(byte); 

} 

xmt(DLE); 

xmtcrc(ETB); 

xmt(crc[0]); 

xmt(crc[l]); 

xeom(PAD); 

end 

# 

# The following example illustrates the use of macros to simulate a 

# function call with arguments. 

# 

# The macro definition: 

# 

define(xmtctl, {c=$ 1 ;d=$2;xmtctl 1())) 

# 

# The function definition: 

# 

function xmtctl 1 () 

xsom(SYNC); 

xmt(c); 

if(d!=0) 

xmt(d); 

xeom(PAD); 

end 

# 

# Sample invocation: 

# 

function test() 

xmtctl(DLE,0x7O); 

end 


FILES 

sas_temp* 

/tmp/sas_ta?? 

/tmp/sas_tb?? 

/usr/lib/vpm/pass* 

/usr/lib/vpm/pl 

/usr/lib/vpm/vratfor 

/lib/cpp 

/usr/bin/m4 

/bin/kasb 

/usr/lib/vpm/bisync/* 

/usr/lib/vpm/hdlc/* 


temporaries 
temporary 
temporary 
compiler phases 
compiler phase 
compiler phase 
preprocessor 
preprocessor 
KMCl 1-B assembler 

interpreter source for the BISYNC interpreter 
interpreter source for the HDLC interpreter 


SEE ALSO 

m4(l), ratfor(l), vpmstart(lC), vpm(4). 

C Reference Manual by D. M. Ritchie. 

RATFOR-A Preprocessor for a Rational Fortran by B. W. Kemighan. 
The M4 Macro Processor by B. W. Kemighan and D. M. Ritchie. 



VPMC(IC) 


VPMC(IC) 


Software Tools by B. W. Kernighan and P. J. Plauger (pp. 28-30). 
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NAME 

vpmstart, vpmsnap, vpmtrace - load the KMCl 1-B; print VPM traces 
SYNOPSIS 

vpmstart device n [ filen ] 
vpmsnap 
vpmtrace 
DESCRIPTION 

Vpmstart writes filen (a.out by default) to the KMC 11 -B specified by device. 

The argument n is a magic number that the KMCl 1-B driver saves to identify the running program. This 
number is checked when the VPM driver is opened to provide some assurance that the program running in 
the KMCl 1-B is the one expected. The magic number for VPM interpreters is 6. When filen has been writ¬ 
ten to the KMCl 1-B, its execution is begun. Filen may be any file executable by the KMCl 1-B. 

If filen is made using vpwc(lC), the VPM interpreter will be started by vpmstart. The VPM interpreter 
waits for a RUN command from the VPM driver before beginning execution of the protocol script. The RUN 
command is sent by the VPM driver when the corresponding VPM device file is opened. 

Vpmsnap opens the trace driver (minor device number 1) and reads and prints time-stamped event records 
until killed. 

Vpmtrace opens the trace driver (minor device number 0) and reads and prints event records until killed. 
SEE ALSO 

vpmc(lC), trace(4), vpm(4). 
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NAME 

vpr - Versatec printer spooler 
SYNOPSIS 

vpr [ options ] [ files ] 

DESCRIPTION 

Vpr causes the named files to be queued for printing on a Versatec printer. If no names appear, the stan¬ 
dard input is assumed; thus vpr may be used as a filter. 

The following options may be given (each as a separate argument and in any order) before any file name 
arguments: 

-c Makes a copy of the file to be sent before returning to the user. 

-r Removes the file after sending it. 

-m When printing is complete, reports that fact by mail(l). 

-n Does not report the completion of printing by mail(\). This is the default option. 

-f Uses the next argument as a dummy file name when reporting completion by mail{l), thus forcing 

the -m option. (This is useful for distinguishing multiple runs, especially when vpr is being used 
as a filter). 

-p [ -e raster ] 

Uses the plot filter vplot to output files produced by graph{\G). The -e option will cause a previ¬ 
ously scan converted file raster to be sent to the Versatec. 

-t Uses the troff filter vcat to output files produced by troJf(\). Troff must be invoked with the -t 
option. 

-nF For n between 1 and 4, assumes font F is mounted in font position n, where F is R, I, B, or S. 

EXAMPLES 

Two common uses are: 

troff -t [ options ] file I vpr -t 
and 

graph [ options ] file I vpr -p 

FILES 

/etc/passwd user’s identification and accounting data 

/usr/spool/vpd/* spool area 

/usr/lib/vpd line printer daemon 

/usr/lib/vpd.pr print filter 

/usr/lbin/vcat troff filter 

/usr/lib/vplot plot filter 

SEE ALSO 

dpr(lC), lpr(l),tplot(lG). 
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NAME 

wait - await completion of process 

SYNOPSIS 

wait 

DESCRIPTION 

Wait until all processes started with & have completed, and report on abnormal terminations. 

Because the wait(2) system call must be executed in the parent process, the shell itself executes wait, with¬ 
out creating a new process. 

SEE ALSO 

sh(l). 

BUGS 

Not all the processes of a 3- or more-stage pipeline are children of the shell, and thus can’t be waited for. 
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NAME 

wall - write to all users 

SYNOPSIS 

/etc/wall 

DESCRIPTION 

Wall reads its standard input until an end-of-file. It then sends this message to all currently logged in users 
preceded by “Broadcast Message from It is used to warn all users, typically prior to shutting down the 
system. 

The sender should be super-user to override any protections the users may have invoked. 

FILES 

/dev/tty* 

SEE ALSO 

mesg(l), write(l). 

DIAGNOSTICS 

“Cannot send to ...” when the open on a user’s tty file fails. 
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NAME 

wc - word count 

SYNOPSIS 

wc [ -Iwc ] [ names ] 

DESCRIPTION 

Wc counts lines, words and characters in the named files, or in the standard input if no names appear. It 
also keeps a total count for all named files. A word is a maximal string of characters delimited by spaces, 
tabs, or new-lines. 

The options I, w, and c may be used in any combination to specify that a subset of lines, words, and charac¬ 
ters are to be reported. The default is -Iwc. 

When names are specified on the command line, they will be printed along with the counts. 
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NAME 

what - identify SCCS files 

SYNOPSIS 

what files 

DESCRIPTION 

What searches the given files for all occurrences of the pattern that get{\.) substitutes for %Z% (this is @(#) 
at this printing) and prints out what follows until the first ", >, new-line, \, or null character. For example, 
if the C program in file f.c contains 

char ident[] = " @(#)identification information 
and f.c is compiled to yield f.o and a.out, then the command 
what f.c f.o a.out 


will print 


f.c: 

identification information 

f.o: 

identification information 

a.out: 

idendfication information 


What is intended to be used in conjunction with the command get{\), which automatically inserts identify¬ 
ing information, but it can also be used where the information is inserted manually. 

SEE ALSO 

get(l),help(l). 

DIAGNOSTICS 

Use help{\.) for explanations. 

BUGS 

It’s possible that an unintended occurrence of the pattern @(#) could be found just by chance, but this 
causes no harm in nearly all cases. 
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NAME 

who - who is on the system 
SYNOPSIS 

who [ who-file ] [ am I ] 

DESCRIPTION 

Who, without an argument, lists the login name, terminal name, and login time for each current UNIX user. 

Without an argument, who examines the /etc/utmp file to obtain its information. If a file is given, that file 
is examined. Typically the given file will be /usr/adm/wtmp, which contains a record of all the logins 
since it was created. Then who lists logins, logouts, and crashes since the creation of the wtmp file. Each 
login is listed with user name, terminal name (with /dev/ suppressed), and date and time. When an argu¬ 
ment is given, logouts produce a similar line without a user name. Reboots produce a line with x in the 
place of the device name, and a fossil time indicative of when the system went down. 

With two arguments, as in who am I (and also who are you), who tells who you are logged in as. 

FILES 

/etc/utmp 

SEE ALSO 

getuid(2), utmp(5). 
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NAME 

whodo “ who is doing what 

SYNOPSIS 

/etc/whodo 

DESCRIPTION 

Whodo produces merged, reformatted, and dated output from the who(l) and^^(l) commands. 

SEE ALSO 

ps(l), who(l). 
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NAME 

write - write to another user 

SYNOPSIS 

write user [ tty ] 

DESCRIPTION 

Write copies lines from your terminal to that of another user. When first called, it sends the message: 
Message from your-logname your-tty ... 

The recipient of the message should write back at this point. Communication continues until an end of file 
is read from the terminal or an interrupt is sent. At that point, write writes EOF on the other terminal and 
exits. 

If you want to write to a user who is logged in more than once, the tty argument may be used to indicate the 
appropriate terminal. 

Permission to write may be denied or granted by use of the mesg{\) command. At the outset, writing is 
allowed. Certain commands, in particular nrojf{\) and pr{\), disallow messages in order to prevent messy 
output. 

If the character ! is found at the beginning of a line, write calls the shell to execute the rest of the line as a 
command. 

The following protocol is suggested for using write: when you first write to another user, wait for him or 
her to write back before starting to send. Each party should end each message with a distinctive signal ((o) 
for “over” is conventional), indicating that the other may reply; (oo) for “over and out” is suggested when 
conversation is to be terminated. 

FILES 

/etc/utmp to find user 

/bin/sh to execute ! 

SEE ALSO 

mail(l), mesg(l), who(l). 
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NAME 

xargs - construct argument list(s) and execute command 
SYNOPSIS 

xargs [ flags ] [ command [ initial-arguments ] ] 

DESCRIPTION 

Xargs combines the fixed initial-arguments with arguments read from standard input to execute the 
specified command one or more times. The number of arguments read for each command invocation and 
the manner in which they are combined are determined by the flags specified. 

Command, which may be a shell file, is searched for, using one’s $PATH. If command is omitted, 
/bin/echo is used. 

Arguments read in from standard input are defined to be contiguous strings of characters delimited by one 
or more blanks, tabs, or new-lines; empty lines are always discarded. Blanks and tabs may be embedded as 
part of an argument if escaped or quoted: Characters enclosed in quotes (single or double) are taken liter¬ 
ally, and the delimiting quotes are removed. Outside of quoted strings a backslash (\) will escape the next 
character. 


Each argument list is constructed starting with the initial-arguments, followed by some number of argu¬ 
ments read from standard input (Exception: see -i flag). Flags -i, -1, and -n determine how arguments are 
selected for each command invocation. When none of these flags are coded, the initial-arguments are fol¬ 
lowed by arguments read continuously from standard input until an internal buffer is full, and then 
command is executed with the accumulated args. This process is repeated until there are no more args. 
When there are flag conflicts (e.g., -1 vs. -n), the last flag has precedence. Flag values are: 


-{number 


-ireplstr 


-nnumber 


-t 

-P 


Command is executed for each non-empty number lines of arguments from stan¬ 
dard input. The last invocation of command will be with fewer lines of arguments 
if fewer than number remain. A line is considered to end with the first new-line 
unless the last character of the line is a blank or a tab; a trailing blank/tab signals 
continuation through the next non-empty line. If number is omitted 1 is assumed. 
Option -X is forced. 

Insert mode: command is executed for each line from standard input, taking the 
entire line as a single arg, inserting it in initial-arguments for each occurrence of 
replstr. A maximum of 5 arguments in initial-arguments may each contain one or 
more instances of replstr. Blanks and tabs at the beginning of each line are 
thrown away. Constructed arguments may not grow larger than 255 characters, 
and option -x is also forced. {} is assumed for replstr if not specified. 

Execute command using as many standard input arguments as possible, up to 
number arguments maximum. Fewer arguments will be used if their total size is 
greater than size characters, and for the last invocation if there are fewer than 
number arguments remaining. If option -x is also coded, each number arguments 
must fit in the size limitation, else xargs terminates execution. 

Trace mode: The command and each constructed argument list are echoed to file 
descriptor 2 just prior to their execution. 

Prompt mode: The user is asked whether to execute command each invocation. 
Trace mode (-t) is turned on to print the command instance to be executed, fol¬ 
lowed by a ?... prompt. A reply of y (optionally followed by anything) will exe¬ 
cute the command; anything else, including just a carriage return, skips that partic¬ 
ular invocation of command. 


-X Causes xargs to terminate if any argument list would be greater than size charac¬ 

ters; -X is forced by the options -i and -1. When neither of the options -i, -I, or -n 
are coded, the total length of all arguments must be within the size limit. 
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-ssize The maximum total size of each argument list is set to size characters; size must 

be a positive integer less than or equal to 470. If -s is not coded, 470 is taken as 
the default. Note that the character count for size includes one extra character for 
each argument and the count of characters in the command name. 

-eeofstr Eofstr is taken as the logical end-of-file string. Underbar (_) is assumed for the 

logical EOF string if -e is not coded, -e with no eofstr coded turns off the logical 
EOF string capability (underbar is taken literally). Xargs reads standard input 
until either end-of-file or the logical EOF string is encountered. 

Xargs will terminate if either it receives a return code of -1 from, or if it cannot execute, command. When 
command is a shell program, it should explicitly exit (see 5/?(l)) with an appropriate value to avoid acci¬ 
dentally returning with - 1 . 

EXAMPLES 

The following will move all files from directory $1 to directory $2, and echo each move command just 
before doing it: 

Is $1 I xargs -i -t mv $l/{ } $2/{ ) 

The following will combine the output of the parenthesized commands onto one line, which is then echoed 
to the end of file log: 

(logname; date; echo $0 $*) | xargs »log 

The user is asked which files in the current directory are to be archived and archives them into arch (1.) one 
at a time, or (2.) many at a time. 

1. Is I xargs -p -1 ar r arch 

2. Is I xargs -p -1 I xargs ar r arch 

The following will execute diff(\) with successive pairs of arguments originally typed as shell arguments: 

echo $* I xargs -n2 diff 

DIAGNOSTICS 

Self explanatory. 
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NAME 

xref - cross reference for C programs 

SYNOPSIS 

xref [ file ... ] 

DESCRIPTION 

Xref reads the named files or the standard input if no file is specified and prints a cross reference consisting 
of lines of the form 

identifier file-name line-numbers... 

Function definition is indicated by a plus sign (+) preceding the line number. 

SEE ALSO 

cref(l). 
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NAME 

yacc - yet another compiler-compiler 
SYNOPSIS 

yacc [ -vd ] grammar 
DESCRIPTION 

Vacc converts a context-free grammar into a set of tables for a simple automaton which executes an LR{1) 
parsing algorithm. The grammar may be ambiguous; specified precedence rules are used to break ambigui¬ 
ties. 

The output file, y.tab.c, must be compiled by the C compiler to produce a program yyparse. This program 
must be loaded with the lexical analyzer program, yylex, as well as main and yyerror, an error handling 
routine. These routines must be supplied by the user; lex(l) is useful for creating lexical analyzers usable 
by yacc. 

If the -V flag is given, the file y.output is prepared, which contains a description of the parsing tables and a 
report on conflicts generated by ambiguities in the grammar. 

If the -d flag is used, the file y.tab.h is generated with the #define statements that associate the yacc- 
assigned “token codes” with the user-declared “token names”. This allows source files other than y.tab.c 
to access the token codes. 


FILES 

y.output 

y.tab.c 

y.tab h defines for token names 

yacc.tmp, yacc.acts temporary files 

/usr/lib/yaccpar parser prototype for C programs 

SEE ALSO 

lex(l). 

LR Parsing by A. V. Aho and S. C. Johnson, Computing Surveys, June, 1974. 

YACC - Yet Another Compiler Compiler by S. C. Johnson. 

DIAGNOSTICS 

The number of reduce-reduce and shift-reduce conflicts is reported on the standard output; a more detailed 
report is found in the y.output file. Similarly, if some rules are not reachable from the start symbol, this is 
also reported. 

BUGS 

Because file names are fixed, at most one yacc process can be active in a given directory at a time. 
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NAME 

intro - introduction to system calls and error numbers 

SYNOPSIS 

#mclude <errno h> 

DESCRIPTION 

This section describes all of the system calls. Most of these calls have one or more error returns. An error 
condition is indicated by an otherwise impossible returned value. This is almost always -1; the individual 
descriptions specify the details. An error number is also made available in the external variable errno. 
Errno is not cleared on successful calls, so it should be tested only after an error has been indicated. 

All of the possible error numbers are not listed in each system call description because many errors are pos¬ 
sible for most of the calls. The following is a complete list of the error numbers and their names as defined 
in <error h>. 

1 EPERM Not owner 

Typically this error indicates an attempt to modify a file in some way forbidden except to its owner 
or super-user. It is also returned for attempts by ordinary users to do things allowed only to the 
super-user. 

2 ENOENT No such file or directory 

This error occurs when a file name is specified and the file should exist but doesn’t, or when one of 
the directories in a path name does not exist. 

3 ESRCH No such process 

No process can be found corresponding to that specified by pid in kill or ptrace. 

4 EINTR Interrupted system call 

An asynchronous signal (such as interrupt or quit), which the user has elected to catch, occurred 
during a system call. If execution is resumed after processing the signal, it will appear as if the 
interrupted system call returned this error condition. 

5 EIO I/O error 

Some physical I/O error. This error may in some cases occur on a call following the one to which 
it actually applies. 

6 ENXIO No such device or address 

I/O on a special file refers to a subdevice which does not exist, or beyond the limits of the device. 
It may also occur when, for example, a tape drive is not on-line or no disk pack is loaded on a 
drive. 

7 E2BIG Arg list too long 

An argument list longer than 5,120 bytes is presented to a member of the exec family. 

8 ENOEXEC Exec format error 

A request is made to execute a file which, although it has the appropriate permissions, does not 
start with a valid magic number (see a.out(5)). 

9 EBADF Bad file number 

Either a file descriptor refers to no open file, or a read (respectively write) request is made to a file 
which is open only for writing (respectively reading). 

10 ECHILD No child processes 

A wait, was executed by a process that had no existing or unwaited-for child processes. 

11 EAGAIN No more processes 

A fork, failed because the system’s process table is full or the user is not allowed to create any 
more processes. 

12 ENOMEM Not enough space 

During an exec, brk, or sbrk, a program asks for more space than the system is able to supply. 
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This is not a temporary condition; the maximum space size is a system parameter. The error may 
also occur if the arrangement of text, data, and stack segments requires too many segmentation 
registers, or if there is not enough swap space during ^fork. 

13 EACCES Permission denied 

An attempt was made to access a file in a way forbidden by the protection system. 

14 EFAULT Bad address 

The system encountered a hardware fault in attempting to use an argument of a system call. 

15 ENOTBLK Block device required 

A non-block file was mentioned where a block device was required, e.g., in mount. 

16 EBUSY Mount device busy 

An attempt to mount a device that was already mounted or an attempt was made to dismount a 
device on which there is an active file (open file, current directory, mounted-on file, active text 
segment). It will also occur if an attempt is made to enable accounting when it is already enabled. 

17 EEXIST File exists 

An existing file was mentioned in an inappropriate context, e.g., link. 

18 EXDEV Cross-device link 

A link to a file on another device was attempted. 

19 ENODEV No such device 

An attempt was made to apply an inappropriate system call to a device; e.g., read a write-only 
device. 

20 ENOTDIR Not a directory 

A non-directory was specified where a directory is required, for example in a path prefix or as an 
argument to chdir(2). 

2 1 EISDIR Is a directory 

An attempt to write on a directory. 

22 EINVAL Invalid argument 

Some invalid argument (e.g., dismounting a non-mounted device; mentioning an undefined signal 
in signal, or kill; reading or writing a file for which Iseek has generated a negative pointer). Also 
set by the math functions described in the (3M) entries of this manual. 

23 ENFILE File table overflow 

The system’s table of open files is full, and temporarily no more opens can be accepted. 

24 EMFILE Too many open files 

No process may have more than 20 file descriptors open at a time. 

25 ENOTTY Not a typewriter 

26 ETXTBSY Text file busy 

An attempt to execute a pure-procedure program which is currently open for writing (or reading). 
Also an attempt to open for writing a pure-procedure program that is being executed. 

27 EFBIG File too large 

The size of a file exceeded the maximum file size (1,082,201,088 bytes) or ULIMIT; see ulimit{2). 

28 ENOSPC No space left on device 

During a write to an ordinary file, there is no free space left on the device. 

29 ESPIPE Illegal seek 

An Iseek was issued to a pipe. 

30 EROFS Read-only file system 

An attempt to modify a file or directory was made on a device mounted read-only. 
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31 EMLINK Too many links 

An attempt to make more than the maximum number of links (1000) to a file. 

32 EPIPE Broken pipe 

A write on a pipe for which there is no process to read the data. This condition normally generates 
a signal; the error is returned if the signal is ignored. 

33 EDOM Math argument 

The argument of a function in the math package (3M) is out of the domain of the function. 

34 ERANGE Result too large 

The value of a function in the math package (3M) is not representable within machine precision. 

DEFINITIONS 
Process ID 

Each active process in the system is uniquely identified by a positive integer called a process ID. The range 
of this ID is from 0 to 30,000. 

Parent Process ID 

A new process is created by a currently active process; seefork(2). The parent process ID of a process is 
the process ID of its creator. 

Process Group ID 

Each active process is a member of a process group that is identified by a positive integer called the process 
group ID. This ID is the process ID of the group leader. This grouping permits the signaling of related pro¬ 
cesses; see kill(2). 

Tty Group ID 

Each active process can be a member of a terminal group that is identified by a positive integer called the 
tty group ID. This grouping is used to terminate a group of related process upon termination of one of the 
processes in the group; see exit(2) and signal{2). 

Real User ID and Real Group ID 

Each user allowed on the system is identified by a positive integer called a real user ID. 

Each user is also a member of a group. The group is identified by a positive integer called the real group 
ID. 

An active process has a real user ID and real group ID that are set to the real user ID and real group ID, 
respectively, of the user responsible for the creation of the process. 

Effective User ID and Effective Group ID 

An active process has an effective user ID and an effective group ID that are used to determine file access 
permissions (see below). The effective user ID and effective group ID are equal to the process’s real user ID 
and real group ID respectively, unless the process or one of its ancestors evolved from a file that had the 
set-user-ID bit or set-group ID bit set; see exec{2). 

Super-user 

A process is recognized as a super-user process and is granted special privileges if its effective user ID is 0. 
Special Processes 

The processes with a process ID of 0 and a process ID of 1 are special processes and are referred to as procO 
and prod. 

ProcO is the scheduler. Prod is the initialization process {init). Prod is the ancestor of every other pro¬ 
cess in the system and is used to control the process structure. 

File Name. 

Names consisting of up to 14 characters may be used to name an ordinary file, special file or directory. 

These characters may be selected from the set of all character values excluding 0 (null) and the ASCII code 
for / (slash). 
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Note that it is generally unwise to use *, ?, [, or ] as part of file names because of the special meaning 
attached to these characters by the shell. See sh(l). 

Path Name and Path Prefix 

A path name is a null-terminated character string starting with an optional slash (/), followed by zero or 
more directory names separated by slashes, optionally followed by a file name. 

More precisely, a path name is a null-terminated character string constructed as follows: 
<path-name>::=<file-name> I <path-prefix><file-name> I / 

<path-prefix>:: =<rtprefix> I /<rtprefix> 

<rtprefix>:: =<dirname>/1 <rtprefix><dirname>/ 

where <file-name> is a string of 1 to 14 characters other than the ASCII slash and null, and <dirname> is a 
string of 1 to 14 characters (other than the ASCII slash and null) that names a directory. 

If a path name begins with a slash, the path search begins at the root directory. Otherwise, the search 
begins from the current working directory. 

A slash by itself names the root directory. 

Unless specifically stated otherwise, the null path name is treated as if it named a non-existent file. 

Directory. 

Directory entries are called links. By convention, a directory contains at least two links,. and referred to 
as dot and dot-dot respectively. Dot refers to the directory itself and dot-dot refers to its parent directory. 

Root Directory and Current Working Directory. 

Each process has associated with it a concept of a root directory and a current working directory for the pur¬ 
pose of resolving path name searches. A process’s root directory need not be the root directory of the root 
file system. 

File Access Permissions. 

Read, write, and execute/search permissions on a file are granted to a process if one or more of the follow¬ 
ing are true: 

The process’s effective user ID is super-user. 

The process’s effective user ID matches the user ID of the owner of the file and the appropriate 
access bit of the “owner” portion (0700) of the file mode is set. 

The process’s effective user ID does not match the user ID of the owner of the file, and the 
process’s group ID matches the group of the file and the appropriate access bit of the “group” por¬ 
tion (070) of the file mode is set. 

The process’s effective user ID does not match the user ID of the owner of the file, and the 
process’s effective group ID does not match the group ID of the file, and the appropriate access bit 
of the “other” portion (07) of the file mode is set. 

Otherwise, the corresponding permissions are denied. 

SEE ALSO 

intro(3). 
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NAME 

access - determine accessibility of a file 
SYNOPSIS 

int access (path, amode) 
char *path; 
int amode; 

DESCRIPTION 

Path points to a path name naming a file. Access checks the named file for accessibility according to the 
bit pattern contained in amode, using the real user ID in place of the effective user ID and the real group ID 
in place of the effective group ID. The bit pattern contained in amode is constructed as follows: 

04 read 

02 write 

01 execute (search) 

00 check existence of file 

Access to the file is denied if one or more of the following are true: 

A component of the path prefix is not a directory. [ENOTDIR] 

Read, write, or execute (search) permission is requested for a null path name. [ENOENT] 

The named file does not exist. [ENOENT] 

Search permission is denied on a component of the path prefix. [EACCES] 

Write access is requested for a file on a read-only file system. [EROFS] 

Write access is requested for a pure procedure (shared text) file that is being executed. [ETXTBSY] 
Permission bits of the file mode do not permit the requested access. [EACCES] 

Path points outside the process’s allocated address space. [EFAULT] 

The owner of a file has permission checked with respect to the “owner” read, write, and execute mode bits, 
members of the file’s group other than the owner have permissions checked with respect to the “group” 
mode bits, and all others have permissions checked with respect to the “other” mode bits. 

RETURN VALUE 

If the requested access is permitted, a value of 0 is returned. Otherwise, a value of-1 is returned and errno 
is set to indicate the error. 

SEE ALSO 

chmod(2), stat(2). 
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NAME 

acct - enable or disable process accounting 

SYNOPSIS 

int acct (path) 
char *path; 

DESCRIPTION 

Acct is used to enable or disable the system’s process accounting routine. If the routine is enabled, an 
accounting record will be written on an accounting file for each process that terminates. Termination can 
be caused by one of two things: an exit call or a signal; see exit(2) and signalil). The effective user ID of 
the calling process must be super-user to use this call. 

Path points to a path name naming the accounting file. The accounting file format is given in acct{5). 

The accounting routine is enabled if path is non-zero and no errors occur during the system call. It is dis¬ 
abled if path is zero and no errors occur during the system call. 

Acct will fail if one or more of the following are true: 

The effective user ID of the calling process is not super-user. [EPERM] 

An attempt is being made to enable accounting when it is already enabled. [EBUSY] 

A component of the path prefix is not a directory. [ENOTDIR] 

One or more components of the accounting file’s path name do not exist. [ENOENT] 

A component of the path prefix denies search permission. [EACCES] 

The file named by path is not an ordinary file. [EACCES] 

Mode permission is denied for the named accounting file. [EACCES] 

The named file is a directory. [EISDIR] 

The named file resides on a read-only file system. [EROFS] 

Path points to an illegal address. [EFAULT] 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of-1 is returned and errno is set 
to indicate the error. 

SEE ALSO 

acct(lM), acct(5). 
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NAME 

alarm - set a process’s alarm clock 
SYNOPSIS 

unsigned alarm (sec) 
unsigned sec; 

DESCRIPTION 

Alarm instructs the calling process’s alarm clock to send the signal SIGALRM to the calling process after 
the number of real time seconds specified by sec have elapsed; see signalil). 

Alarm requests are not stacked; successive calls reset the calling process’s alarm clock. 

If sec is 0, any previously made alarm request is canceled. 

RETURN VALUE 

Alarm returns the amount of time previously remaining in the calling process’s alarm clock. 

SEE ALSO 

pause(2), signal(2). 
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NAME 

brk, sbrk - change data segment space allocation 

SYNOPSIS 

int brk (endds) 
char *endds; 

char *sbrk (incr) 
int incr; 

DESCRIPTION 

Brk and sbrk are used to change dynamically the amount of space allocated for the calling process’s data 
segment; see exec{2). The change is made by resetting the process’s break value. The break value is the 
address of the first location beyond the end of the data segment. The amount of allocated space increases as 
the break value increases. 

Brk sets the break value to endds and changes the allocated space accordingly. 

Sbrk adds incr bytes to the break value and changes the allocated space accordingly. Incr can be negative, 
in which case the amount of allocated space is decreased. 

Brk and sbrk will fail without making any change in the allocated space if such a change would result in 
more space being allocated than is allowed by a system-imposed maximum (see ulimit(2)). [ENOMEM] 

RETURN VALUE 

Upon successful completion, brk returns a value of 0 and sbrk returns the old break value. Otherwise, a 
value of-1 is returned and errno is set to indicate the error. 

SEE ALSO 

exec(2). 
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NAME 

chdir - change working directory 

SYNOPSIS 

int chdir (path) 
char *path; 

DESCRIPTION 

Path points to the path name of a directory. Chdir causes the named directory to become the current work¬ 
ing directory, the starting point for path searches for path names not beginning with /. 

Chdir will fail and the current working directory will be unchanged if one or more of the following are true: 
A component of the path name is not a directory. [ENOTDIR] 

The named directory does not exist. [ENOENT] 

Search permission is denied for any component of the path name. [EACCES] 

Path points outside the process’s allocated address space. [EFAULT] 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned and errno is set 
to indicate the error. 

SEE ALSO 

chroot(2). 
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NAME 

chmod - change mode of file 
SYNOPSIS 

int chmod (path, mode) 
char *path; 
int mode; 

DESCRIPTION 

Path points to a path name naming a file. Chmod sets the access permission portion of the named file’s 
mode according to the bit pattern contained in mode. 

Access permission bits are interpreted as follows: 

04000 Set user ID on execution. 

02000 Set group ID on execution. 

01000 Save text image after execution 
00400 Read by owner 
00200 Write by owner 

00100 Execute (or search if a directory) by owner 
00070 Read, write, execute (search) by group 
00007 Read, write, execute (search) by others 

The effective user ID of the process must match the owner of the file or be super-user to change the mode of 
a file. 

If the effective user ID of the process is not super-user, mode bit 01000 (save text image on execution) is 
cleared. 

If the effective user ID of the process is not super-user or the effective group ID of the process does not 
match the group ID of the file, mode bit 02000 (set group ID on execution) is cleared. 

If an executable file is prepared for sharing then mode bit 01000 prevents the system from abandoning the 
swap-space image of the program-text portion of the file when its last user terminates. Thus, when the next 
user of the file executes it, the text need not be read from the file system but can simply be swapped in, sav¬ 
ing time. 

Chmod will fail and the file mode will be unchanged if one or more of the following are true: 

A component of the path prefix is not a directory. [ENOTDIR] 

The named file does not exist. [ENOENT] 

Search permission is denied on a component of the path prefix. [EACCES] 

The effective user ID does not match the owner of the file and the effective user ID is not super- 
user. [EPERM] 

The named file resides on a read-only file system. [EROFS] 

Path points outside the process’s allocated address space. [EFAULT] 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned and errno is set 
to indicate the error. 

SEE ALSO 

chown(2), mknod(2). 
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NAME 

chown - change owner and group of a file 
SYNOPSIS 

int chown (path, owner, group) 

char *path; 

int owner, group; 

DESCRIPTION 

Path points to a path name naming a file. The owner ID and group ID of the named file are set to the 
numeric values contained in owner and group respectively. 

Only processes with effective user ID equal to the file owner or super-user may change the ownership of a 
file. 

If chown is invoked by other than the super-user, the set-user-lD and set-group-ID bits of the file mode, 
04000 and 02000 respectively, will be cleared. 

Chown will fail and the owner and group of the named file will remain unchanged if one or more of the fol¬ 
lowing are true: 

A component of the path prefix is not a directory. [ENOTDIR] 

The named file does not exist. [ENOENT] 

Search permission is denied on a component of the path prefix. [EACCES] 

The effective user ID does not match the owner of the file and the effective user ID is not super- 
user. [EPERM] 

The named file resides on a read-only file system. [EROFS] 

Path points outside the process’s allocated address space. [EFAULT] 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned and errno is set 
to indicate the error. 

SEE ALSO 

chmod(2). 
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NAME 

chroot - change root directory 

SYNOPSIS 

int chroot (path) 
char *path; 

DESCRIPTION 

Path points to a path name naming a directory. Chroot causes the named directory to become the root 
directory, the starting point for path searches for path names beginning with /. 

The effective user ID of the process must be super-user to change the root directory. 

The .. entry in the root directory is interpreted to mean the root directory itself. Thus,.. can not be used to 
access files outside the subtree rooted at the root directory. 

Chroot will fail and the root directory will remain unchanged if one or more of the following are true: 

Any component of the path name is not a directory. [ENOTDIR] 

The named directory does not exist. [ENOENT] 

The effective user ID is not super-user. [EPERM] 

Path points outside the process’s allocated address space. [EFAULT] 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned and errno is set 
to indicate the error. 

SEE ALSO 

chdir(2). 
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NAME 

close - close a file descriptor 

SYNOPSIS 

int close (fildes) 
int fildes; 

DESCRIPTION 

Fildes is a file descriptor obtained from a creat, open, dup,fcntl, or pipe system call. Close closes the file 
descriptor indicated by fildes. 

Close will fail if fildes is not a valid open file descriptor. [EBADF] 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned and errno is set 
to indicate the error. 

SEE ALSO 

creat(2), dup(2), exec(2), fcntl(2), open(2), pipe(2). 
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NAME 

creat - create a new file or rewrite an existing one 
SYNOPSIS 

int creat (path, mode) 
char *path; 
int mode; 

DESCRIPTION 

Creat creates a new ordinary file or prepares to rewrite an existing file named by the path name pointed to 
by path. 

If the file exists, the length is truncated to 0 and the mode and owner are unchanged. Otherwise, the file’s 
owner ID is set to the process’s effective user ID, the file’s group ID is set to the process’s effective group 
ID, and the low-order 12 bits of the file mode are set to the value of mode modified as follows: 

All bits set in the process’s file mode creation mask are cleared. See umaskil). 

The ‘ ‘save text image after execution bit’ ’ of the mode is cleared. See chmod(2). 

Upon successful completion, a non-negative integer, namely the file descriptor, is returned and the file is 
open for writing, even if the mode does not permit writing. The file pointer is set to the beginning of the 
file. The file descriptor is set to remain open across exec system calls. Seefcntl(2). No process may have 
more than 20 files open simultaneously. A new file may be created with a mode that forbids writing. 

Creat will fail if one or more of the following are true: 

A component of the path prefix is not a directory. [ENOTDIR] 

A component of the path prefix does not exist. [ENOENT] 

Search permission is denied on a component of the path prefix. [EACCES] 

The path name is null. [ENOENT] 

The file does not exist and the directory in which the file is to be created does not permit writing. 
[EACCES] 

The named file resides or would reside on a read-only file system. [EROFS] 

The file is a pure procedure (shared text) file that is being executed. [ETXTBSY] 

The file exists and write permission is denied. [EACCES] 

The named file is an existing directory. [EISDIR] 

Twenty (20) file descriptors are currently open. [EMFILE] 

Path points outside the process’s allocated address space. [EFAULT] 

RETURN VALUE 

Upon successful completion, a non-negative integer, namely the file descriptor, is returned. Otherwise, a 
value of-1 is returned and errno is set to indicate the error. 

SEE ALSO 

close(2), dup(2), lseek(2), open(2), read(2), umask(2), write(2). 
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NAME 

dup - duplicate an open file descriptor 

SYNOPSIS 

int dup (fildes) 
int fildes; 

DESCRIPTION 

Fildes is a file descriptor obtained from a creat, open, dup,fcntl, or pipe system call. Dup returns a new 
file descriptor having the following in common with the original: 

Same open file (or pipe). 

Same file pointer, (i.e., both file descriptors share one file pointer.) 

Same access mode (read, write or read/write). 

The new file descriptor is set to remain open across exec system calls. Seefcnd(2). 

The file descriptor returned is the lowest one available. 

Dup will fail if one or more of the following are true: 

Fildes is not a valid open file descriptor. [EBADF] 

Twenty (20) file descriptors are currently open. [EMFILE] 

RETURN VALUE 

Upon successful completion a non-negative integer, namely the file descriptor, is returned. Otherwise, a 
value of-1 is returned and errno is set to indicate the error. 

SEE ALSO 

creat(2), close(2), exec(2), fcntl(2), open(2), pipe(2). 
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NAME 

execl, execv, execle, execve, execlp, execvp - execute a file 
SYNOPSIS 

int execl (path, argO, argl,argn, 0) 
char *path, *arg0, *argl,*argn; 

int execv (path, argv) 
char *path, *argv[ ]; 

int execle (path, argO, argl,argn, 0, envp) 
char *path, *arg0, *argl,..., *argn, *envp[ ]; 

int execve (path, argv, envp); 
char *path, *argv[ ], *envp[ ]; 

int execlp (file, argO, argl,..., argn, 0) 
char *file, *argO, *argl,*argn; 

int execvp (file, argv) 
char *file, *argv[ ]; 

DESCRIPTION 

Exec in all its forms transforms the calling process into a new process. The new process is constructed 
from an ordinary, executable file called the new process file. This file consists of a header (see a.out{5)), a 
text segment, and a data segment. The data segment contains an initialized portion and an uninitialized por¬ 
tion (bss). There can be no return from a successful exec because the calling process is overlaid by the new 
process. 

Path points to a path name that identifies the new process file. 

File points to the new process file. The path prefix for this file is obtained by a search of the directories 
passed as the environment line "PATH =" (see environ{l)). The environment is supplied by the shell (see 
5/1(1)). 

ArgO, argl, ..., argn are pointers to null-terminated character strings. These strings constitute the argu¬ 
ment list available to the new process. By convention, at least argO must be present and point to a string 
that is the same as path (or its last component). 

Argv is an array of character pointers to null-terminated strings. These strings constitute the argument list 
available to the new process. By convention, argv must have at least one member, and it must point to a 
string that is the same as path (or its last component). Argv is terminated by a null pointer. 

Envp is an array of character pointers to null-terminated strings. These strings constitute the environment 
for the new process. Envp is terminated by a null pointer. 

File descriptors open in the calling process remain open in the new process, except for those whose 
close-on-exec flag is set; see fend(2). For those file descriptors that remain open, the file pointer is 
unchanged. 

Signals set to terminate the calling process will be set to terminate the new process. Signals set to be 
ignored by the calling process will be set to be ignored by the new process. Signals set to be caught by the 
calling process will be set to terminate new process; see signalil). 

If the set-user-ID mode bit of the new process file is set (see chmod(2)), exec sets the effective user ID of 
the new process to the owner ID of the new process file. Similarly, if the set-group-ID mode bit of the new 
process file is set, the effective group ID of the new process is set to the group ID of the new process file. 
The real user ID and real group ID of the new process remain the same as those of the calling process. 

Profiling is disabled for the new process; see profil(2). 

The new process also inherits the following attributes from the calling process: 
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nice value (see nice(2)) 
process ID 
parent process ID 
process group ID 

tty group ID (see exitil) and signal(2)) 

trace flag (see ptrace(2) request 0) 

time left until an alarm clock signal (see alarm{2)) 

current working directory 

root directory 

file mode creation mask (see umask{2)) 

file size limit (see ulimit(2)) 

utime, stime, cutime, and cstime (see times {2)) 

Exec will fail and return to the calling process if one or more of the following are true: 

One or more components of the new process file’s path name do not exist. [ENOENT] 

A component of the new process file’s path prefix is not a directory. [ENOTDIR] 

Search permission is denied for a directory listed in the new process file’s path prefix. [EACCES] 
The new process file is not an ordinary file. [EACCES] 

The new process file mode denies execution permission. [EACCES] 

The new process file has the appropriate access permission, but has an invalid magic number in its 
header. [ENOEXEC] 

The new process file is a pure procedure (shared text) file that is currently open for writing by 
some process. [ETXTBSY] 

The new process requires more memory than is allowed by the system-imposed maximum 
MAXMEM. [ENOMEM] 

The number of bytes in the new process’s argument list is greater than the system-imposed limit of 
5120 bytes. [E2BIG] 

The new process file is not as long as indicated by the size values in its header. [EFAULT] 

Path, argv, or envp point to an illegal address. [EFAULT] 

RETURN VALUE 

If exec returns to the calling process an error has occurred; the return value will be -1 and errno will be set 
to indicate the error. 

SEE ALSO 

exit(2), fork(2). 
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NAME 

exit - terminate process 

SYNOPSIS 

exit (status) 
int status; 

DESCRIPTION 

Exit terminates the calling process with the following consequences: 

All of the file descriptors open in the calling process are closed. 

If the parent process of the calling process is executing a wait, it is notified of the calling process’s 
termination and the low order eight bits (i.e., bits 0377) of status are made available to it; see 
wait(2). 

If the parent process of the calling process is not executing a wait, the calling process is trans¬ 
formed into a zombie process. A zombie process is a process that only occupies a slot in the pro¬ 
cess table, it has no other space allocated either in user or kernel space. The process table slot that 
it occupies is partially overlaid with time accounting information (see <sys/proc.h>) to be used by 
times. 

The parent process ID of all of the calling process’s existing child processes and zombie processes 
is set to 1. This means the initialization process (see intro (2)) inherits each of these processes. 

An accounting record is written on the accounting file if the system’s accounting routine is 
enabled; see acct(2). 

If the process ID, tty group ID, and process group ID of the calling process are equal, the SIGHUP 
signal is sent to each processes that has a process group ID equal to that of the calling process. 

SEE ALSO 

signal(2), wait(2). 

WARNING 

See WARNING in signal(2). 
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NAME 

fcntl - file control 


SYNOPSIS 

#include <fcntl h> 

int fcntl (tildes, cmd, arg) 
int tildes, cmd, arg; 

DESCRIPTION 

Fcntl provides for control over open files. Fildes is an open file descriptor obtained from a creat, open, 
dup, fcntl, or pipe system call. 

The cmds, available are: 


F_DUPFD Return a new file descriptor as follows: 

Lowest numbered available file descriptor greater than or equal to arg. 

Same open file (or pipe) as the original file. 

Same file pointer as the original file (i.e., both file descriptors share one file pointer). 

Same access mode (read, write or read/write). 

Same file status flags (i.e., both file descriptors share the same file status flags). 

The close-on-exec flag associated with the new file descriptor is set to remain open across 
exec(2) system calls. 

F_GETFD Get the close-on-exec flag associated with the file descriptor fildes. If the low-order bit is 0 
the file will remain open across exec, otherwise the file will be closed upon execution of exec. 

F_SETFD Set the close-on-exec flag associated with fildes to the low-order bit of arg (0 or 1 as above). 
F_GETFL Get file status flags. 

F_SETFL Set file status flags to arg. Only certain flags can be set; seefcntlil). 

Fcntl will fail if one or more of the following are true: 

Fildes is not a valid open file descriptor. [EBADF] 

Cmd is F_DUPFD and 20 file descriptors are currently open. [EMFILE] 

Cmd is F_DUPFD and arg is negative or greater than 20. [EINVAL] 


RETURN VALUE 

Upon successful completion, the value returned depends on cmd as follows: 
F_DUPFD A new file descriptor. 

F_GETFD Value of flag (only the low-order bit is defined). 
F_SETFD V alue other than -1. 

F_GETFL Value of file flags. 

F_SETFL V alue other than -1. 

Otherwise, a value of-1 is returned and errno is set to indicate the error. 


SEE ALSO 

close(2), exec(2), open(2), fcntl(7). 
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NAME 

fork - create a new process 

SYNOPSIS 

int fork () 

DESCRIPTION 

Fork causes creation of a new process. The new process (child process) is an exact copy of the calling pro¬ 
cess (parent process) except for the following: 

The child process has a unique process ID. 

The child process has a different parent process ID (i.e., the process ID of the parent process). 

The child process has its own copy of the parent’s file descriptors. Each of the child’s file descrip¬ 
tors shares a common file pointer with the corresponding file descriptor of the parent. 

The child process’s utime, stime, cutime, and cstime are set to 0; see times(2). 

Fork returns a value of 0 to the child process. 

Fork returns the process ID of the child process to the parent process. 

Fork will fail and no child process will be created if one or more of the following are true: 

The system-imposed limit on the total number of processes under execution would be exceeded. 
[EAGAIN] 

The system-imposed limit on the total number of processes under execution by a single user would 
be exceeded. [EAGAIN] 

RETURN VALUE 

Upon successful completion,/or/: returns a value of 0 to the child process and returns the process ID of the 
child process to the parent process. Otherwise, a value of-1 is returned to the parent process, no child pro¬ 
cess is created, and errno is set to indicate the error. 

SEE ALSO 

exec(2), wait(2). 
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NAME 

getpid, getpgrp, getppid - get process, process group, and parent process IDs 

SYNOPSIS 

int getpid () 

int getpgrp () 
int getppid () 

DESCRIPTION 

Getpid returns the process ID of the calling process. 

Getpgrp returns the process group ID of the calling process. 

Getppid returns the parent process ID of the calling process. 

SEE ALSO 

exec(2), fork(2), intro(2), setpgrp(2), signal(2). 
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NAME 

getuid, geteuid, getgid, getegid - get real user, effective user, real group, and effective group IDs 

SYNOPSIS 

int getuid () 

int geteuid () 
int getgid () 
int getegid () 

DESCRIPTION 

Getuid returns the real user ID of the calling process. 

Geteuid returns the effective user ID of the calling process. 

Getgid returns the real group ID of the calling process. 

Getegid returns the effective group ID of the calling process. 

SEE ALSO 

intro(2), setuid(2). 
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NAME 

ioctl - control device 
SYNOPSIS 

#mclude <sys/ioctl.h> 
ioctl(fildes, request, arg) 

DESCRIPTION 

Ioctl performs a variety of functions on character special files (devices). The writeups of various devices in 
Section 4 discuss how ioctl applies to them. 

Ioctl will fail if one or more of the following are true: 

Fildes is not a valid open file descriptor. [EBADF] 

Fildes is not associated with a character special device. [ENOTTY] 

Request ox arg is, not wdXid. Seer/>’(4). [EINVAL] 

RETURN VALUE 

If an error has occurred, a value of-1 is returned and errno is set to indicate the error. 

SEE ALSO 

tty(4). 
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NAME 

kill - send a signal to a process or a group of processes 

SYNOPSIS 

int kill (pid, sig) 
int pid, sig; 

DESCRIPTION 

Kill sends a signal to a process or a group of processes. The process or group of processes to which the sig¬ 
nal is to be sent is specified by pid. The signal that is to be sent is specified by sig and is either one from 
the list given in signal(2), or 0. If sig is 0 (the null signal), error checking is performed but no signal is 
actually sent. This can be used to check the validity of pid. 

The effective user ID of the sending process must match the real user ID of the receiving process unless, the 
effective user ID of the sending process is super-user, or the process is sending to itself. 

The processes with a process ID of 0 and a process ID of 1 are special processes (see intro(2)) and will be 
referred to below as procO and prod respectively. 

If pid is greater than zero, sig will be sent to the process whose process ID is equal to pid. Pid may equal 
1 . 

If pid is 0, sig will be sent to all processes excluding procO and prod whose process group ID is equal to 
the process group ID of the sender. 

If pid is -1 and the effective user ID of the sender is not super-user, sig will be sent to all processes exclud¬ 
ing procO and prod whose real user ID is equal to the effective user ID of the sender. 

If pid is -1 and the effective user ID of the sender is super-user, sig will be sent to all processes excluding 
procO and prod. 

If pid is negative but not -1, sig will be sent to all processes whose process group ID is equal to the abso¬ 
lute value of pid. 

Kill will fail and no signal will be sent if one or more of the following are true: 

Sig is not a valid signal number. [EINVAL] 

No process can be found corresponding to that specified by pid. [ESRCH] 

The sending process is not sending to itself, its effective user ID is not super-user, and its effective 
user ID does not match the real user ID of the receiving process. [EPERM] 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned and errno is set 
to indicate the error. 

SEE ALSO 

kill(l), getpid(2), setpgrp(2), signal(2). 
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NAME 

link - link to a file 
SYNOPSIS 

int link (pathl, path2) 
char *pathl, *path2; 

DESCRIPTION 

Pathl points to a path name naming an existing file. Pathl points to a path name naming the new directory 
entry to be created. Link creates a new link (directory entry) for the existing file. 

Link will fail and no link will be created if one or more of the following are true: 

A component of either path prefix is not a directory. [ENOTDIR] 

A component of either path prefix does not exist. [ENOENT] 

A component of either path prefix denies search permission. [EACCES] 

The file named by pathl does not exist. [ENOENT] 

The link named by pathl exists. [EEXIST] 

The file named by pathl is a directory and the effective user ID is not super-user. [EPERM] 

The link named by pathl and the file named by pathl are on different logical devices (file sys¬ 
tems). [EXDEV] 

Pathl points to a null path name. [ENOENT] 

The requested link requires writing in a directory with a mode that denies write permission. 
[EACCES] 

The requested link requires writing in a directory on a read-only file system. [EROFS] 

Path points outside the process’s allocated address space. [EFAULT] 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned and errno is set 
to indicate the error. 

SEE ALSO 

link(lM), unlink(2). 
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NAME 

Iseek - move read/write file pointer 
SYNOPSIS 

long Iseek (fildes, offset, whence) 
int tildes; 
long offset; 
int whence; 

DESCRIPTION 

Fildes is a file descriptor returned from a creat, open, dup, or fcntl system call. Lseek sets the file pointer 
associated with fildes as follows: 

If whence is 0, the pointer is set to ojfset bytes. 

If whence is 1, the pointer is set to its current location plus ojfset. 

If whence is 2, the pointer is set to the size of the file plus ojfset. 

Upon successful completion, the resulting pointer location as measured in bytes from the beginning of the 
file is returned. 

Lseek will fail and the file pointer will remain unchanged if one or more of the following are true: 

Fildes is not an open file descriptor. [EBADF] 

Fildes is associated with a pipe or fifo. [ESPIPE] 

Whence is not 0, 1 or 2. [EINVAL and SIGSYS signal] 

The resulting file pointer would be negative. [EINVAL] 

Some devices are incapable of seeking. The value of the file pointer associated with such a device is 
undefined. 

RETURN VALUE 

Upon successful completion, a non-negative integer indicating the file pointer value is returned. Otherwise, 
a value of-1 is returned and errno is set to indicate the error. 

SEE ALSO 

creat(2), dup(2), fcntl(2), open(2). 
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NAME 

mknod - make a directory, or a special or ordinary file 
SYNOPSIS 

int mknod (path, mode, dev) 
char *path; 
int mode, dev; 

DESCRIPTION 

Mknod creates a new file named by the path name pointed to by path. The mode of the new file is initial¬ 
ized from mode. Where the value of mode is interpreted as follows: 

0170000 file type; one of the following: 

0010000 fifo special 
0020000 character special 
0040000 directory 
0060000 block special 
0100000 or 0000000 ordinary file 
0004000 set user ID on execution 
0002000 set group ID on execution 
0001000 save text image after execution 
0000777 access permissions; constructed from the following 
0000400 read by owner 
0000200 write by owner 

0000100 execute (search on directory) by owner 
0000070 read, write, execute (search) by group 
0000007 read, write, execute (search) by others 

Values of mode other than those above are undefined and should not be used. 

The file’s owner ID is set to the process’s effective user ID. The file’s group ID is set to the process’s effec¬ 
tive group ID. 

The low-order 9 bits of mode are modified by the process’s file mode creation mask: all bits set in the 
process’s file mode creation mask are cleared. See umaskil). If mode indicates a block or character special 
file, dev is a configuration dependent specification of a character or block I/O device. If mode does not 
indicate a block special or character special device, dev is ignored. 

Mknod may be invoked only by the super-user for file types other than FIFO special. 

Mknod will fail and the new file will not be created if one or more of the following are true: 

The process’s effective user ID is not super-user. [EPERM] 

A component of the path prefix is not a directory. [ENOTDIR] 

A component of the path prefix does not exist. [ENOENT] 

The directory in which the file is to be created is located on a read-only file system. [EROFS] 

The named file exists. [EEXIST] 

Path points outside the process’s allocated address space. [EFAULT] 

RETURN VALUE 

Upon successful completion a value of 0 is returned. Otherwise, a value of-1 is returned and errno is set 
to indicate the error. 

SEE ALSO 

mkdir(l), mknod(lM), chmod(2), exec(2), umask(2), fs(5). 
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NAME 

mount - mount a file system 
SYNOPSIS 

int mount (spec, dir, rwflag) 
char *spec, *dir; 
int rwflag; 

DESCRIPTION 

Mount requests that a removable file system contained on the block special file identified by spec be 
mounted on the directory identified by dir. Spec and dir are pointers to path names. 

Upon successful completion, references to the file dir will refer to the root directory on the mounted file 
system. 

The low-order bit of rwflag is used to control write permission on the mounted file system; if 1, writing is 
forbidden, otherwise writing is permitted according to individual file accessibility. 

Mount may be invoked only by the super-user. 

Mount will fail if one or more of the following are true: 

The effective user ID is not super-user. [EPERM] 

Any of the named files does not exist. [ENOENT] 

A component of a path prefix is not a directory. [ENOTDIR] 

Spec is not a block special device. [ENOTBLK] 

The device associated with spec does not exist. [ENXIO] 

Dir is not a directory. [ENOTDIR] 

Spec or dir points outside the process’s allocated address space. [EFAULT] 

Dir is currently mounted on, is someone’s current working directory or is otherwise busy. 
[EBUSY] 

The device associated with spec is currently mounted. [EBUSY] 

RETURN VALUE 

Upon successful completion a value of 0 is returned. Otherwise, a value of-1 is returned and errno is set 
to indicate the error. 

SEE ALSO 

mount(lM), umount(2). 
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NAME 

nice - change priority of a process 

SYNOPSIS 

int nice (incr) 
int incr; 

DESCRIPTION 

Nice adds the value of incr to the nice value of the calling process. A process’s nice value is a positive 
number for which a more positive value results in lower CPU priority. 

A maximum nice value of 39 and a minimum nice value of 0 are imposed by the system. Requests for val¬ 
ues above or below these limits result in the nice value being set to the corresponding limit. 

Nice will fail and not change the nice value if incr is negative and the effective user ID of the calling pro¬ 
cess is not super-user. [EPERM] 

RETURN VALUE 

Upon successful completion, nice returns the new nice value minus 20. Otherwise, a value of -1 is 
returned and errno is set to indicate the error. 

SEE ALSO 

nice(l), exec(2). 
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NAME 

open - open for reading or writing 

SYNOPSIS 

#include <fcntl h> 

int open (path, oflag[, mode]) 

char *path; 

int oflag, mode; 

DESCRIPTION 

Path points to a path name naming a file. Open opens a file descriptor for the named file and sets the file 
status flags according to the value of oflag. Oflag values are constructed by or-ing flags from the following 
list (only one of the first three flags below may be used): 

0_RD0NLY Open for reading only. 

0_WR0NLY Open for writing only. 

0_RDWR Open for reading and writing. 

0_NDELAY This flag may affect subsequent reads and writes. See read{2) and write(2). 

When opening a FIFO with 0_RD0NLY or 0_WR0NLY set: 

IfO NDELAY is set: 

An open for reading-only will return without delay. An open for writing-only will 
return an error if no process currently has the file open for reading. 

If O NDELAY is clear: 

An open for reading-only will block until a process opens the file for writing. An 
open for writing-only will block until a process opens the file for reading. 

When opening a file associated with a communication line: 

IfONDELAY is set: 

The open will return without waiting for carrier. 

If O NDELAY is clear: 

The open will block until carrier is present. 

0_APPEND If set, the file pointer will be set to the end of the file prior to each write. 

0_CREAT If the file exists, this flag has no effect. Otherwise, the file’s owner ID is set to the process’s 

effective user ID, the file’s group ID is set to the process’s effective group ID, and the low- 

order 12 bits of the file mode are set to the value of mode modified as follows (see 

creat(2)): 

All bits set in the process’s file mode creation mask are cleared. See umask(2). 

The “save text image after execution bit’ ’ of the mode is cleared. See chmod{2). 
0_TRUNC If the file exists, its length is truncated to 0 and the mode and owner are unchanged. 
0_EXCL If 0_EXCL and 0_CREAT are set, open will fail if the file exists. 

Upon successful completion a non-negative integer, the file descriptor, is returned. 

The file pointer used to mark the current position within the file is set to the beginning of the file. 

The new file descriptor is set to remain open across exec system calls. Seefcntl(2). 

No process may have more than 20 file descriptors open simultaneously. 

The named file is opened unless one or more of the following are true: 
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A component of the path prefix is not a directory. [ENOTDIR] 

0_CREAT is not set and the named file does not exist. [ENOENT] 

A component of the path prefix denies search permission. [EACCES] 

Ofiag permission is denied for the named file. [EACCES] 

The named file is a directory and oflag is write or read/write. [EISDIR] 

The named file resides on a read-only file system and oflag is write or read/write. [EROFS] 

Twenty (20) file descriptors are currently open. [EMFILE] 

The named file is a character special or block special file, and the device associated with this spe¬ 
cial file does not exist. [ENXIO] 

The file is a pure procedure (shared text) file that is being executed and oflag is write or read/write. 
[ETXTBSY] 

Path points outside the process’s allocated address space. [EFAULT] 

0_CREAT and 0_EXCL are set, and the named file exists. [EEXIST] 

0_NDELAY is set, the named file is a FIFO, 0_WR0NLY is set, and no process has the file open for 
reading. [ENXIO] 

RETURN VALUE 

Upon successful completion, a non-negative integer, namely a file descriptor, is returned. Otherwise, a 
value of-1 is returned and errno is set to indicate the error. 

SEE ALSO 

close(2), creat(2), dup(2), fcntl(2), lseek(2), read(2), write(2). 
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NAME 

pause - suspend process until signal 

SYNOPSIS 

pause () 

DESCRIPTION 

Pause suspends the calling process until it receives a signal. The signal must be one that is not currently 
set to be ignored by the calling process. 

If the signal causes termination of the calling process, pause will not return. 

If the signal is caught by the calling process and control is returned from the signal catching-function (see 
signal(2)), the calling process resumes execution from the point of suspension; with a return value of -1 
from pause and errno set to EINTR. 

SEE ALSO 

alarm(2), kill(2), signal(2), wait(2). 
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NAME 

pipe - create an interprocess channel 

SYNOPSIS 

int pipe (fildes) 
int tildes[2]; 

DESCRIPTION 

Pipe creates an I/O mechanism called a pipe and returns two file descriptors, fildes{QI\ and fildes{l]. 
Fildes[Qi\ is opened for reading Sindfildes[\] is opened for writing. 

Writes up to 5120 bytes of data are buffered by the pipe before the writing process is blocked. A read on 
file descriptor fildes[Q] accesses the data written to jildeslX] on a first-in-first-out basis. 

No process may have more than 20 file descriptors open simultaneously. 

Pipe will fail if 19 or more file descriptors are currently open. [EMFILE] 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned and errno is set 
to indicate the error. 

SEE ALSO 

sh(l), read(2), write(2). 
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NAME 

profil - execution time profile 
SYNOPSIS 

profil (buff, bufsiz, offset, scale) 
char *buff; 

int bufsiz, offset, scale; 

DESCRIPTION 

Buff points to an area of core whose length (in bytes) is given by bufsiz. After this call, the user’s program 
counter (pc) is examined each clock tick (60th second); offset is subtracted from it, and the result multiplied 
by scale. If the resulting number corresponds to a word inside buff, that word is incremented. 

The scale is interpreted as an unsigned, fixed-point fraction with binary point at the left: 0177777 (octal) 
gives a 1-1 mapping of pc’s to words in buff\ 077777 (octal) maps each pair of instruction words together. 
02(8) maps all instructions onto the beginning of buff (producing a non-interrupting core clock). 

Profiling is turned off by giving a scale of 0 or 1. It is rendered ineffective by giving a bufsiz of 0. 
Profiling is turned off when an exec is executed, but remains on in child and parent both after a. fork. 
Profiling will be turned off if an update in buff would cause a memory fault. 

RETURN VALUE 

Not defined. 

SEE ALSO 

prof(l), monitor(3C). 
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NAME 

ptrace - process trace 
SYNOPSIS 

int ptrace (request, pid, addr, data); 
int request, pid, addr, data; 

DESCRIPTION 

Ptrace provides a means by which a parent process may control the execution of a child process. Its pri¬ 
mary use is for the implementation of breakpoint debugging; see adb{\). The child process behaves nor¬ 
mally until it encounters a signal (see signalil) for the list), at which time it enters a stopped state and its 
parent is notified via wait{2). When the child is in the stopped state, its parent can examine and modify its 
“core image” using ptrace. Also, the parent can cause the child either to terminate or continue, with the 
possibility of ignoring the signal that caused it to stop. 

The request argument determines the precise action to be taken by ptrace and is one of the following: 

0 This request must be issued by the child process if it is to be traced by its parent. It turns on 
the child’s trace flag that stipulates that the child should be left in a stopped state upon 
receipt of a signal rather than the state specified hy func\ see signal{2). The pid, addr, and 
data arguments are ignored, and a return value is not defined for this request. Peculiar 
results will ensue if the parent does not expect to trace the child. 

The remainder of the requests can only be used by the parent process. For each, pid is the process ID of the 
child. The child must be in a stopped state before these requests are made. 

1, 2 With these requests, the word at location addr in the address space of the child is returned to 
the parent process. If I and D space are separated (as on PDP-1 Is), request 1 returns a word 
from I space, and request 2 returns a word from D space. If I and D space are not separated 
(as on the VAX-11/780), either request 1 or request 2 may be used with equal results. The 
data argument is ignored. These two requests will fail if addr is not the start address of a 
word, in which case a value of -1 is returned to the parent process and the parent’s errno is 
set to EIO. 

3 With this request, the word at location addr in the child’s USER area in the system’s address 
space (see <sys/user h>) is returned to the parent process. Addresses in this area range from 
0 to 1024 on the PDP-1 Is and 0 to 2048 on the VAX. The data argument is ignored. This 
request will fail if addr is not the start address of a word or is outside the USER area, in 
which case a value of -1 is returned to the parent process and the parent’s errno is set to 
EIO. 

4,5 With these requests, the value given by the data argument is written into the address space 
of the child at location addr. If I and D space are separated (as on PDP-1 Is), request 4 
writes a word into I space, and request 5 writes a word into D space. If I and D space are 
not separated (as on the VAX), either request 4 or request 5 may be used with equal results. 
Upon successful completion, the value written into the address space of the child is returned 
to the parent. These two requests will fail if addr is a location in a pure procedure space and 
another process is executing in that space, or addr is not the start address of a word. Upon 
failure a value of -1 is returned to the parent process and the parent’s errno is set to EIO. 

6 With this request, a few entries in the child’s USER area can be written. Data gives the 
value that is to be written and addr is the location of the entry. The few entries that can be 
written are: 

the general registers (i.e., registers 0-7 on PDP-1 Is, and registers 0-15 on the 
VAX) 

the floating point status register and six floating point registers on PDP-1 Is 
certain bits of the Processor Status Word on PDP-1 Is (i.e, bits 0-4, and 8-11) 
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certain bits of the Processor Status Longword on the VAX (i.e., bits 0-7, 16-20, 
and 30-31) 

7 This request causes the child to resume execution. If the data argument is 0, all pending 
signals including the one that caused the child to stop are canceled before it resumes execu¬ 
tion. If the data argument is a valid signal number, the child resumes execution as if it had 
incurred that signal and any other pending signals are canceled. The addr argument must be 
equal to 1 for this request. Upon successful completion, the value of data is returned to the 
parent. This request will fail if data is not 0 or a valid signal number, in which case a value 
of -1 is returned to the parent process and the parent’s errno is set to EIO. 

8 This request causes the child to terminate with the same consequences as exit{T). 

9 This request sets the trace bit in the Processor Status Word of the child (i.e., bit 4 on PDP- 
1 Is; bit 30 on the VAX) and then executes the same steps as listed above for request 7. The 
trace bit causes on interrupt upon completion of one machine instruction. This effectively 
allows single stepping of the child. 

Note: the trace bit remains set after an interrupt on PDP-lls but is turned off after an inter¬ 
rupt on the VAX. 

To forestall possible fraud, ptrace inhibits the set-user-id facility on subsequent execil) calls. If a traced 
process calls exec, it will stop before executing the first instruction of the new image showing signal 
SIGTRAP. 

GENERAL ERRORS 

Ptrace will in general fail if one or more of the following are true: 

Request is an illegal number. [EIO] 

Pid identifies a child that does not exist or has not executed a ptrace with request 0. [ESRCH] 

SEE ALSO 

adb(l), exec(2), signal(2), wait(2). 
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NAME 

read - read from file 
SYNOPSIS 

int read (fildes, buf, nbyte) 
int bides; 
char *buf; 
unsigned nbyte; 

DESCRIPTION 

Fildes is a file descriptor obtained from a creat, open, dup,fcntl, or pipe system call. 

Read attempts to read nbyte bytes from the file associated With fildes into the buffer pointed to by buf. 

On devices capable of seeking, the read starts at a position in the file given by the file pointer associated 
with fildes. Upon return from read, the file pointer is incremented by the number of bytes actually read. 

Devices that are incapable of seeking always read from the current position. The value of a file pointer 
associated with such a file is undefined. 

Upon successful completion, read returns the number of bytes actually read and placed in the buffer; this 
number may be less than nbyte if the file is associated with a communication line (see ioctlil) and tty{A)), 
or if the number of bytes left in the file is less than nbyte bytes. A value of 0 is returned when an end-of- 
file has been reached. 

When attempting to read from an empty pipe (or FIFO): 

If 0_NDELAY is set, the read will return a 0. 

If 0_NDELAY is clear, the read will block until data is written to the file or the file is no longer 
open for writing. 

When attempting to read a file associated with a tty that has no data currently available: 

If 0_NDELAY is set, the read will return a 0. 

If 0_NDELAY is clear, the read will block until data becomes available. 

Read will fail if one or more of the following are true: 

Fildes is not a valid file descriptor open for reading. [EBADF] 

Buf points outside the allocated address space. [EFAULT] 

RETURN VALUE 

Upon successful completion a non-negative integer is returned indicating the number of bytes actually read. 
Otherwise, a -1 is returned and errno is set to indicate the error. 

SEE ALSO 

creat(2), dup(2), fcntl(2), ioctl(2), open(2), pipe(2), tty(4). 
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NAME 

setpgrp - set process group ID 

SYNOPSIS 

int setpgrp () 

DESCRIPTION 

Setpgrp sets the process group ID of the calling process to the process ID of the calling process and returns 
the new process group ID. 

RETURN VALUE 

Setpgrp returns the value of the new process group ID. 

SEE ALSO 

exec(2), fork(2), getpid(2), intro(2), kill(2), signal(2). 
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NAME 

setuid, setgid - set user and group IDs 

SYNOPSIS 

int setuid (uid) 
int uid; 

int setgid (gid) 
int gid; 

DESCRIPTION 

Setuid is used to set the real user ID and effective user ID of the calling process. 

Setgid is used to set the real group ID and effective group ID of the calling process. 

If the effective user ID of the calling process is super-user, the real user (group) ID and effective user 
(group) ID are set to uid (gid). 

If the effective user ID of the calling process is not super-user, but its real user (group) ID is equal to uid 
(gid), the effective user (group) ID is set to uid (gid). 

Setuid will fail if the real user (group) ID of the calling process is not equal to uid (gid) and its effective 
user ID is not super-user. [EPERM] 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned and errno is set 
to indicate the error. 

SEE ALSO 

getuid(2), intro(2). 
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NAME 

signal - specify what to do upon receipt of a signal 

SYNOPSIS 

#mclude <signal.h> 

int (^signal (sig, func))() 

int sig; 

int (*func)(); 

DESCRIPTION 

Signal allows the calling process to choose one of three ways in which it is possible to handle the receipt of 
a specific signal. Sig specifies the signal and func specifies the choice. 

Sig can be assigned any one of the following except SIGKILL: 


SIGHUPOl 

hangup 


SIGINT 

02 

interrupt 

SIGQUIT 

03* 

quit 

SIGILL 

04* 

illegal instruction (not reset when caught) 

SIGTRAP 

05* 

trace trap (not reset when caught) 

SIGIOT 

06* 

lOT instruction 

SIGEMT 

07* 

EMT instruction 

SIGFPE 

08* 

floating point exception 

SIGKILL 

09 

kill (cannot be caught or ignored) 

SIGBUS 10* 

bus error 

SIGSEGV 

11* 

segmentation violation 

SIGSYS 

12* 

bad argument to system call 

SIGPIPE 

13 

write on a pipe with no one to read it 

SIGALRM 

14 

alarm clock 

SIGTERM 

15 

software termination signal 

SIGUSRl 

16 

user defined signal 1 

SIGUSR2 

17 

user defined signal 2 

SIGCLD18 

death of a child (see WARNING below) 

SIGPWR 

19 

power fail (see WARNING below) 


See below for the significance of the asterisk in the above list. 

Func is assigned one of three values: SIG_DFL, SIG_IGN, or a function address. The actions prescribed by 
these values of are as follows: 

SIG_DFL - terminate process upon receipt of a signal 

Upon receipt of the signal sig, the receiving process is to be terminated with the following con¬ 
sequences: 

All of the receiving process’s open file descriptors will be closed. 

If the parent process of the receiving process is executing a wait, it will be notified of the 
termination of the receiving process and the terminating signal’s number will be made 
available to the parent process; see wait(2). 

If the parent process of the receiving process is not executing a wait, the receiving process 
will be transformed into a zombie process (see exit(2) for definition of zombie process). 

The parent process ID of each of the receiving process’s existing child processes and zom¬ 
bie processes will be set to 1. This means the initialization process (see intro(2)) inherits 
each of these processes. 

An accounting record will be written on the accounting file if the system’s accounting 
routine is enabled; see acct(2). 
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If the receiving process’s process ID, tty group ID, and process group ID are equal, the sig¬ 
nal SIGHUP will be sent to all of the processes that have a process group ID equal to the 
process group ID of the receiving process. 

A “core image’’ will be made in the current working directory of the receiving process if 
sig is one for which an asterisk appears in the above list and the following conditions are 
met: 

The effective user ID and the real user ID of the receiving process are equal. 

An ordinary file named core exists and is writable or can be created. If the file 
must be created, it will have the following properties: 

a mode of 0666 modified by the file creation mask (see umaskil)) 

a file owner ID that is the same as the effective user ID of the receiv¬ 
ing process 

a file group ID that is the same as the effective group ID of the receiv¬ 
ing process 

SIG_IGN - ignore signal 

The signal sig is to be ignored. 

Note: the signal SIGKILL cannot be ignored. 
function address - catch signal 

Upon receipt of the signal sig, the receiving process is to execute the signal-catching function 
pointed to by func. The signal number sig will be passed as the only argument to the signal- 
catching function. 

Upon return from the signal-catching function, the receiving process will resume execution at 
the point it was interrupted and the value of func for the caught signal will be set to SIG_DFL 
unless the signal is SIGILL, SIGTRAP, SIGCLD, or SIGPWR. 

When a signal that is to be caught occurs during a read, a write, an open, or an ioctl system 
call on a slow device (like a terminal; but not a file), during a pause system call, or during a 
wait system call that does not return immediately due to the existence of a previously stopped 
or zombie process, the signal catching function will be executed and then the interrupted sys¬ 
tem call will return a -1 to the calling process with errno set to EINTR. 

Note: the signal SIGKILL cannot be caught. 

A call to signal cancels a pending signal sig except for a pending SIGKILL signal. 

Signal will fail if one or more of the following are true: 

Sig is an illegal signal number, including SIGKILL. [EINVAL] 

Func points to an illegal address. [EFAULT] 

RETURN VALUE 

Upon successful completion, signal returns the previous value of func for the specified signal sig. Other¬ 
wise, a value of -1 is returned and errno is set to indicate the error. 

SEE ALSO 

kill(l), kill(2), pause(2), ptrace(2), wait(2), setjmp(3C). 

WARNING 

Two other signals that behave differently than the signals described above exist in this release of the sys¬ 
tem; they are: 

SIGCLD 18 death of a child (not reset when caught) 

SIGPWR 19 power fail (not reset when caught) 
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There is no guarantee that, in future releases of UNIX, these signals will continue to behave as described 
below; they are included only for compatibility with other versions of UNIX. Their use in new programs is 
strongly discouraged. 

For these signals,is assigned one of three values: SIG_DFL, SIG_IGN, or a function address. The 
actions prescribed by these values of are as follows: 

SIG_DFL - ignore signal 

The signal is to be ignored. 

SIG_IGN - ignore signal 

The signal is to be ignored. Also, if is SIGCLD, the calling process’s child processes will 
not create zombie processes when they terminate; see exit(2). 

function address - catch signal 

If the signal is SIGPWR, the action to be taken is the same as that described above for func 
equal to function address. The same is true if the signal is SIGCLD except, that while the pro¬ 
cess is executing the signal-catching function any received SIGCLD signals will be queued and 
the signal-catching function will be continually reentered until the queue is empty. 

The SIGCLD affects two other system calls (wait(2), and exit(2)) in the following ways: 

wait If the func value of SIGCLD is set to SIG_IGN and a wait is executed, the wait will block until 
all of the calling process’s child processes terminate; it will then return a value of -1 with 
errno set to ECHILD. 

exit If in the exiting process’s parent process the func value of SIGCLD is set to SIG_IGN, the exit¬ 
ing process will not create a zombie process. 

When processing a pipeline, the shell makes the last process in the pipeline the parent of the proceeding 
processes. A process that may be piped into in this manner (and thus become the parent of other pro¬ 
cesses) should take care not to set SIGCLD to be caught. 
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NAME 

stat, fstat - get file status 
SYNOPSIS 

#include <sys/types h> 

#mclude <sys/stat.h> 

int stat (path, but) 
char *path; 
struct stat *buf; 

int fstat (hides, buf) 
int hides; 
struct stat *buf; 

DESCRIPTION 

Path points to a path name naming a hie. Read, write or execute permission of the named hie is not 
required, but all directories listed in the path name leading to the hie must be searchable. Stat obtains 
information about the named hie. 

Similarly,/vmr obtains information about an open hie known by the hie descriptor jildes, obtained from a 
successful open, creat, dup,fcntl, or pipe system call. 

Buf is a pointer to a stat structure into which information is placed concerning the hie. 

The contents of the structure pointed to by buf include the following members: 


u short 

St mode; 

/* File mode; see mknod(2) */ 

ino t 

St ino; 

/* Inode number */ 

dev t 

St dev; 

/* ID of device containing */ 

/* a directory entry for this hie */ 

dev t 

St rdev; 

/* ID of device */ 

/* This entry is dehned only for */ 

/* character special or block special hies */ 

short 

St nlink; 

/* Number of links */ 

u short 

St uid; 

/* User ID of the hle’s owner */ 

u short 

St gid; 

/* Group ID of the hle’s group */ 

off_t 

St size; 

/* File size in bytes */ 

time t 

St atime; 

/* Time of last access */ 

time t 

St mtime; 

/* Time of last data modihcation */ 

time t 

St ctime; 

/* Time of last hie status change */ 

/* Times measured in seconds since */ 

/* 00:00:00 GMT, Jan. 1, 1970 */ 


st atime Time when hie data was last accessed. Changed by the following system calls: creat{2), 
mknod(2), pipe{2), utime{2), and read{2). 

st_mtime Time when data was last modihed. Changed by the following system calls: creat(2), 
mknod(2), pipe{2), utime{2), and write{2). 

st ctime Time when hie status was last changed. Changed by the following system calls: chmod{2), 
chown(2), creat{2), link{2), mknod{2), pipe(2), unlink{2), utimeiT), and write{2). 

Stat will fail if one or more of the following are true: 

A component of the path prehx is not a directory. [ENOTDIR] 

The named hie does not exist. [ENOENT] 

Search permission is denied for a component of the path prehx. [EACCES] 

Buf or path points to an invalid address. [EFAULT] 
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Fstat will fail if one or more of the following are true: 

Fildes is not a valid open file descriptor. [EBADF] 

Buf points to an invalid address. [EFAULT] 

RETURN VALUE 

Upon successful completion a value of 0 is returned. Otherwise, a value of-1 is returned and errno is set 
to indicate the error. 

SEE ALSO 

chmod(2), chown(2), creat(2), link(2), mknod(2), time(2), unlink(2). 



STIME(2) 


STIME(2) 


NAME 

stime - set time 

SYNOPSIS 

int stime (tp) 
long *tp; 

DESCRIPTION 

Stime sets the system’s idea of the time and date. Tp points to the value of time as measured in seconds 
from 00:00:00 GMT January 1, 1970. 

Stime will fail if the effective user ID of the calling process is not super-user. [EPERM] 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned and errno is set 
to indicate the error. 

SEE ALSO 

time(2). 
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NAME 

sync - update super-block 

SYNOPSIS 

sync() 

DESCRIPTION 

Sync causes all information in memory that should be on disk to be written out. This includes modified 
super blocks, modified i-nodes, and delayed block I/O. 

It should be used by programs which examine a file system, for example df, etc. It is mandatory 
before a boot. 

The writing, although scheduled, is not necessarily complete upon return from sync. 

SEE ALSO 

sync(lM). 
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NAME 

time - get time 
SYNOPSIS 

long time ((long *) 0) 

long time (tloc) 
long *tloc; 

DESCRIPTION 

Time returns the value of time in seconds since 00:00:00 GMT, January 1, 1970. 

If tloc (taken as an integer) is non-zero, the return value is also stored in the location to which tloc points. 
Time will fail if tloc points to an illegal address. [EFAULT] 

RETURN VALUE 

Upon successful completion, time returns the value of time. Otherwise, a value of-1 is returned and errno 
is set to indicate the error. 

SEE ALSO 

stime(2). 
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NAME 

times - get process and child process times 

SYNOPSIS 

long times (buffer) 
struct tbuffer ^buffer; 
struct tbuffer { 


long 

utime; 

long 

stime; 

long 

cutime 

long 

cstime; 


} 

DESCRIPTION 

Times fills the structure pointed to by buffer with time-accounting information. This information comes 
from the calling process and each of its terminated child processes for which it has executed a wait. 

All times are in 60ths of a second. 

Utime is the CPU time used while executing instructions in the user space of the calling process. 

Stime is the CPU time used by the system on behalf of the calling process. 

Cutime is the sum of the utimes and cutimes of the child processes. 

Cstime is the sum of the stimes and cstimes of the child processes. 

Times will fail if buffer points to an illegal address. [EFAULT] 

RETURN VALUE 

Upon successful completion, times returns the elapsed real time, in 60ths of a second, since an arbitrary 
point in the past (e.g., system start-up time). This point does not change from one invocation of times to 
another. If times fails, a -1 is returned and errno is set to indicate the error. 

SEE ALSO 

exec(2), fork(2), time(2), wait(2). 
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NAME 

□limit - get and set user limits 
SYNOPSIS 

long ulimit (cmd, newlimit) 
int cmd; 
long newlimit; 

DESCRIPTION 

This function provides for control over process limits. The cmd values available are: 

1 Get the process’s file size limit. The limit is in units of 512-byte blocks and is inherited by child pro¬ 
cesses. Files of any size can be read. 

2 Set the process’s file size limit to the value of newlimit. Any process may decrease this limit, but 
only a process with an effective user ID of super-user may increase the limit. Ulimit will fail and the 
limit will be unchanged if a process with an effective user ID other than super-user attempts to 
increase its file size limit. [EPERM] 

3 Get the maximum possible break value. See brk(2). 

RETURN VALUE 

Upon successful completion, a non-negative value is returned. Otherwise, a value of -1 is returned and 
errno is set to indicate the error. 

SEE ALSO 

brk(2), write(2). 
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NAME 

□mask - set and get file creation mask 

SYNOPSIS 

int umask (cmask) 
int cmask; 

DESCRIPTION 

Umask sets the process’s file mode creation mask to cmask and returns the previous value of the mask. 
Only the low-order 9 bits of cmask and the file mode creation mask are used. 

RETURN VALUE 

The previous value of the file mode creation mask is returned. 

SEE ALSO 

mkdir(l), mknod(lM), sh(l), chmod(2), creat(2), mknod(2), open(2). 
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NAME 

□mount - unmount a file system 

SYNOPSIS 

int umount (spec) 
char *spec; 

DESCRIPTION 

Umount requests that a previously mounted file system contained on the block special device identified by 
spec be unmounted. Spec is a pointer to a path name. After unmounting the file system, the directory upon 
which the file system was mounted reverts to its ordinary interpretation. 

Umount may be invoked only by the super-user. 

Umount will fail if one or more of the following are true: 

The process’s effective user ID is not super-user. [EPERM] 

Spec does not exist. [ENXIO] 

Spec is not a block special device. [ENOTBLK] 

Spec is not mounted. [EINVAL] 

A file on spec is busy. [EBUSY] 

Spec points outside the process’s allocated address space. [EEAULT] 

RETURN VALUE 

Upon successful completion a value of 0 is returned. Otherwise, a value of-1 is returned and errno is set 
to indicate the error. 

SEE ALSO 

mount(lM), mount(2). 
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NAME 

uname - get name of current UNIX system 
SYNOPSIS 

#include <sys/utsname h> 

int uname (name) 
struct utsname *name; 

DESCRIPTION 

Uname stores information identifying the current UNIX system in the structure pointed to by name. 
Uname uses the structure defined in <sys/utsname.h>: 
struct utsname { 


char 

sysname[9]; 

char 

nodename[9]; 

char 

release[9]; 

char 

version[9]; 


extern struct utsname utsname; 

Uname returns a null-terminated character string naming the current UNIX system in the character array 
sysname. Similarly, nodename contains the name that the system is known by on a communications net¬ 
work. Release and version further identify the operating system. 

Uname will fail if name points to an invalid address. [EFAULT] 

RETURN VALUE 

Upon successful completion, a non-negative value is returned. Otherwise, -1 is returned and errno is set to 
indicate the error. 

SEE ALSO 

uname(l). 
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NAME 

unlink - remove directory entry 

SYNOPSIS 

int unlink (path) 
char *path; 

DESCRIPTION 

Unlink removes the directory entry named by the path name pointed to be path. 

The named file is unlinked unless one or more of the following are true: 

A component of the path prefix is not a directory. [ENOTDIR] 

The named file does not exist. [ENOENT] 

Search permission is denied for a component of the path prefix. [EACCES] 

Write permission is denied on the directory containing the link to be removed. [EACCES] 

The named file is a directory and the effective user ID of the process is not super-user. [EPERM] 
The entry to be unlinked is the mount point for a mounted file system. [EBUSY] 

The entry to be unlinked is the last link to a pure procedure (shared text) file that is being executed. 
[ETXTBSY] 

The directory entry to be unlinked is part of a read-only file system. [EROFS] 

Path points outside the process’s allocated address space. [EFAULT] 

When all links to a file have been removed and no process has the file open, the space occupied by the file 
is freed and the file ceases to exist. If one or more processes have the file open when the last link is 
removed, the removal is postponed until all references to the file have been closed. 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned and errno is set 
to indicate the error. 

SEE ALSO 

rm(l), close(2), link(2), open(2). 
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NAME 

ustat - get file system statistics 
SYNOPSIS 

#include <sys/types h> 

#mclude <ustat.h> 

int ustat (dev, buf) 
int dev; 

struct ustat *buf; 

DESCRIPTION 

Ustat returns information about a mounted file system. Dev is a device number identifying a device con¬ 
taining a mounted file system. Buf is a pointer to a ustat structure that includes to following elements: 

daddr_t f_tfree; /* Total free blocks */ 

ino_t f_tinode; /* Number of free inodes */ 

char f_fname[6]; /* Filsys name */ 

char f_fpack[6]; /* Filsys pack name */ 

Ustat will fail if one or more of the following are true: 

Dev is not the device number of a device containing a mounted file system. [EINVAL] 

Buf points outside the process’s allocated address space. [EFAULT] 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned and errno is set 
to indicate the error. 

SEE ALSO 

stat(2), fs(5). 
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NAME 

□time - set file access and modification times 
SYNOPSIS 

#mclude <sys/types h> 
int utime (path, times) 
char *path; 
struct utimbuf *times; 

DESCRIPTION 

Path points to a path name naming a file. Utime sets the access and modification times of the named file. 

If times is NULL, the access and modification times of the file are set to the current time. A process must 
be the owner of the file or have write permission to use utime in this manner. 

If times is not NULL, times is interpreted as a pointer to a utimbuf structure and the access and modification 
times are set to the values contained in the designated structure. Only the owner of the file or the super-user 
may use utime this way. 

The times in the following structure are measured in seconds since 00:00:00 GMT, Jan. 1, 1970. 
struct utimbuf { 

time_t actime; /* access time */ 
time_t modtime; /* modification time */ 

}; 

Utime will fail if one or more of the following are true: 

The named file does not exist. [ENOENT] 

A component of the path prefix is not a directory. [ENOTDIR] 

Search permission is denied by a component of the path prefix. [EACCES] 

The effective user ID is not super-user and not the owner of the file and times is not NULL. 
[EPERM] 

The effective user ID is not super-user and not the owner of the file and times is NULL and write 
access is denied. [EACCES] 

The file system containing the file is mounted read-only. [EROFS] 

Times is not NULL and points outside the process’s allocated address space. [EFAULT] 

Path points outside the process’s allocated address space. [EFAULT] 

RETURN VALUE 

Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned and errno is set 
to indicate the error. 

SEE ALSO 

stat(2). 
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NAME 

wait - wait for child process to stop or terminate 

SYNOPSIS 

int wait (stat loc) 
int *stat_loc; 

int wait ((int *)0) 

DESCRIPTION 

Wait suspends the calling process until it receives a signal that is to be caught (see signalil)), or until any 
one of the calling process’s child processes stops in a trace mode (see ptraceil)) or terminates. If a child 
process stopped or terminated prior to the call on wait, return is immediate. 

If statjoc (taken as an integer) is non-zero, 16 bits of information called status are stored in the low order 
16 bits of the location pointed to by statjoc. Status can be used to differentiate between stopped and ter¬ 
minated child processes and if the child process terminated, status identifies the cause of termination and 
pass useful information to the parent. This is accomplished in the following manner: 

If the child process stopped, the high order 8 bits of status will be zero and the low order 8 bits 
will be set equal to 0177. 

If the child process terminated due to an exit call, the low order 8 bits of status will be zero and the 
high order 8 bits will contain the low order 8 bits of the argument that the child process passed to 
exit; see exit(2). 

If the child process terminated due to a signal, the high order 8 bits of status will be zero and the 
low order 8 bits will contain the number of the signal that caused the termination. In addition, if 
the low order seventh bit (i.e., bit 200) is set, a “core image” will have been produced; see 
signaliT). 

If a parent process terminates without waiting for its child processes to terminate, the parent process ID of 
each child process is set to 1. This means the initialization process inherits the child processes; see introil). 

Wait will fail and return immediately if one or more of the following are true: 

The calling process has no existing unwaited-for child processes. [ECHILD] 

Statjoc points to an illegal address. [EFAULT] 

RETURN VALUE 

If wait returns due to the receipt of a signal, a value of -1 is returned to the calling process and errno is set 
to EINTR. If wait returns due to a stopped or terminated child process, the process ID of the child is 
returned to the calling process. Otherwise, a value of-1 is returned and errno is set to indicate the error. 

SEE ALSO 

exec(2), exit(2), fork(2), pause(2), signal(2). 

WARNING 

See WARNING in signal(2). 
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NAME 

write “ write on a file 
SYNOPSIS 

int write (Aides, buf, nbyte) 
int Aides; 
char *buf; 
unsigned nbyte; 

DESCRIPTION 

Fildes is a file descriptor obtained from a creat, open, dup,fcntl, or pipe system call. 

Write attempts to write nbyte bytes from the buffer pointed to by buf to the file associated with the fildes. 

On devices capable of seeking, the actual writing of data proceeds from the position in the file indicated by 
the file pointer. Upon return from write, the file pointer is incremented by the number of bytes actually 
written. 

On devices incapable of seeking, writing always takes place starting at the current position. The value of a 
file pointer associated with such a device is undefined. 

If the 0_APPEND fiag of the file status fiags is set, the file pointer will be set to the end of the file prior to 
each write. 

Write will fail and the file pointer will remain unchanged if one or more of the following are true: 

Fildes is not a valid file descriptor open for writing. [EBADF] 

An attempt is made to write to a pipe that is not open for reading by any process. [EPIPE and SIG- 
PIPE signal] 

An attempt was made to write a file that exceeds the process’s file size limit or the maximum file 
size. See ulimit(2). [EFBIG] 

Buf points outside the process’s allocated address space. [EFAULT] 

If a write requests that more bytes be written than there is room for (e.g., the ulimit (see ulimit(2)) or the 
physical end of a medium), only as many bytes as there is room for will be written. For example, suppose 
there is space for 20 bytes more in a file before reaching a limit. A write of 512 bytes will return 20. The 
next write of a non-zero number of bytes will give a failure return (except as noted below). 

If the file being written is a pipe (or FIFO), no partial writes will be permitted. Thus, the write will fail if a 
write of nbyte bytes would exceed a limit. 

If the file being written is a pipe (or FIFO) and the 0_NDELAY flag of the file flag word is set, then write to 
a full pipe (or FIFO) will return a count of 0. Otherwise (0_NDELAY clear), writes to a full pipe (or FIFO) 
will block until space becomes available. 

RETURN VALUE 

Upon successful completion the number of bytes actually written is returned. Otherwise, -1 is returned and 
errno is set to indicate the error. 

SEE ALSO 

creat(2), dup(2), lseek(2), open(2), pipe(2), ulimit(2). 
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NAME 

intro - introduction to subroutines and libraries 

SYNOPSIS 

#mclude <stdio h> 

#mclude <math.h> 

DESCRIPTION 

This section describes functions found in various libraries, other than those functions that directly invoke 
UNIX system primitives, which are described in Section 2 of this volume. Certain major collections are 
identified by a letter after the section number: 

(3C) These functions, together with those of Section 2 and those marked (3S), constitute library libc, 
which is automatically loaded by the C compiler, cc(l). The link editor W(l) searches this library 
under the -Ic option. Declarations for some of these functions may be obtained from #include files 
indicated on the appropriate pages. 

(3M) These functions constitute the math library, lihm. They are automatically loaded as needed by the 
FORTRAN compiler/77(1). The link editor searches this library under the -Im option. Declara¬ 
tions for these functions may be obtained from the #mclude file <math h>. 

(3S) These functions constitute the “standard I/O package” (see stdio{3S)). These functions are in the 
library libc, already mentioned. Declarations for these functions may be obtained from the 
#mclude file <stdio.h>. 

(3X) Various specialized libraries. The files in which these libraries are found are given on the appropri¬ 
ate pages. 

The descriptions of some functions refer to NULL. This is the value that is obtained by casting 0 into a 
character pointer. The C language guarantees that this value will not match that of any legitimate pointer, 
so many functions that return pointers return it, for example, to indicate an error. NULL is defined in 
<stdio.h> as 0; the user can include his own definition if he is not using <stdio.h>. 

FILES 

/lib/libc.a 

/lib/libm.a 

SEE ALSO 

ar(l), cc(l), n7(l), ld(l), nm(l), intro(2), stdio(3S). 

DIAGNOSTICS 

Functions in the math library (3M) may return conventional values when the function is undefined for the 
given arguments or when the value is not representable. In these cases, the external variable errno (see 
intro (2)) is set to the value EDOM or ERANGE. 
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NAME 

a641,164a - convert between long and base-64 ASCII 

SYNOPSIS 

long a641 (s) 
char *s; 

char *164a (1) 
long 1; 

DESCRIPTION 

These routines are used to maintain numbers stored in hase-64 ASCII. This is a notation by which long 
integers can be represented by up to six characters; each character represents a “digit” in a radix-64 nota¬ 
tion. 

The characters used to represent ‘ ‘digits’ ’ are . for 0, / for 1, 0 through 9 for 2-11, A through Z for 12-37, 
and a through z for 38-63. 

A641 takes a pointer to a null-terminated base-64 representation and returns a corresponding long value. 
L64a takes a long argument and returns a pointer to the corresponding base-64 representation. 

BUGS 

The value returned by I64a is a pointer into a static buffer, the contents of which are overwritten by each 
call. 
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NAME 

abort - generate an lOT fault 

SYNOPSIS 

abort () 

DESCRIPTION 

Abort causes an lOT signal to be sent to the process. This usually results in termination with a core dump. 
It is possible for abort to return control if SIGIOT is caught or ignored. 

SEE ALSO 

adb(l), exit(2), signal(2). 

DIAGNOSTICS 

Usually ‘ ‘abort - core dumped’ ’ from the shell. 
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NAME 

abs - integer absolute value 

SYNOPSIS 

int abs (i) 
int i; 

DESCRIPTION 

Abs returns the absolute value of its integer operand. 

SEE ALSO 

fabs(3M). 

BUGS 

You get what the hardware gives on the largest negative integer. 



ASSERT(3X) 


ASSERT(3X) 


NAME 

assert - program verification 

SYNOPSIS 

#mclude <assert.h> 

assert (expression); 

DESCRIPTION 

This macro is useful for putting diagnostics into programs. When it is executed, if expression is false, it 
prints “Assertion failed: file xyz, line nnn"' on the standard error file and exits. Xyz is the source file and 
nnn the source line number of the assert statement. Compiling with the preprocessor option -DNDEBUG 
(see cc(l)) will cause assert to be ignored. 
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NAME 

atof, atoi, atol - convert ASCII to numbers 

SYNOPSIS 

double atof (nptr) 
char *nptr; 

int atoi (nptr) 
char *nptr; 

long atoi (nptr) 
char *nptr; 

DESCRIPTION 

These functions convert a string pointed to by nptr to floating, integer, and long integer representation 
respectively. The first unrecognized character ends the string. 

Atof recognizes an optional string of tabs and spaces, then an optional sign, then a string of digits optionally 
containing a decimal point, then an optional e or E followed by an optionally signed integer. 

Atoi and atoi recognize an optional string of tabs and spaces, then an optional sign, then a string of digits. 

SEE ALSO 

scanf(3S). 

BUGS 

There are no provisions for overflow. 
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NAME 

jO, j 1, jn, yO, y 1, yn - bessel functions 

SYNOPSIS 

#mclude <math.h> 

double jO (x) 
double x; 

double jl (x) 
double x; 

double jn (n, x); 
double x; 

double yO (x) 
double x; 

double yl (x) 
double x; 

double yn (n, x) 
int n; 
double x; 

DESCRIPTION 

These functions calculate Bessel functions of the first and second kinds for real arguments and integer 
orders. 

DIAGNOSTICS 

Negative arguments cause yO, yl , and yn to return a huge negative value. 
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NAME 

bsearch - binary search 
SYNOPSIS 

char *bsearch (key, base, nel, width, compar) 

char *key; 

char *base; 

int nel, width; 

int (*compar)(); 

DESCRIPTION 

Bsearch is a binary search routine generalized from Knuth (6.2.1) Algorithm B. It returns a pointer into a 
table indicating the location at which a datum may be found. The table must be previously sorted in 
increasing order. The first argument is a pointer to the datum to be located in the table. The second argu¬ 
ment is a pointer to the base of the table. The third is the number of elements in the table. The fourth is the 
width of an element in bytes. The last is the name of the comparison routine. It is called with two argu¬ 
ments which are pointers to the elements being compared. The routine must return an integer less than, 
equal to, or greater than 0 according as the first argument is to be considered less than, equal to, or greater 
than the second. 

DIAGNOSTICS 

Zero is returned if the key can not be found in the table. 

SEE ALSO 

lsearch(3C), qsort(3C). 
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NAME 

toupper, tolower, toascii - character translation 

SYNOPSIS 

#mclude <ctype h> 

int toupper (c) 
int c; 

int tolower (c) 
int c; 

int toupper (c) 
int c; 

int tolower (c) 
int c; 

int toascii (c) 
int c; 

DESCRIPTION 

If the argument 
If the argument 

of tolower represents an upper-case letter, the result is the corresponding lower-case letter. All other argu¬ 
ments in the domain are returned unchanged. 

Joupper and jolower are macros that accomplish the same thing as toupper and tolower but have 
restricted domains and are faster, joupper requires a lower-case letter as its argument; its result is the cor¬ 
responding upper-case letter, jolower requires an upper-case letter as its argument; its result is the corre¬ 
sponding lower-case letter. Arguments outside the domain cause garbage results. 

Toascii yields its argument with all bits turned off that are not part of a standard ASCII character; it is 
intended for compatibility with other systems. 

SEE ALSO 

ctype(3C). 


Toupper and tolower have as domain the range of getc: the integers from -1 through 255. 
of toupper represents a lower-case letter, the result is the corresponding upper-case letter. 
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NAME 

crypt, setkey, encrypt - DES encryption 
SYNOPSIS 

char *crypt (key, salt) 
char *key, *salt; 

setkey (key) 
char *key; 

encrypt (block, edflag) 
char *block; 
int edflag; 

DESCRIPTION 

Crypt is the password encryption routine. It is based on the NBS Data Encryption Standard (DES), with 
variations intended (among other things) to frustrate use of hardware implementations of the DES for key 
search. 

The first argument to crypt is a user’s typed password. The second is a 2-character string chosen from the 
set [a-zA-Z0“9/]; this salt string is used to perturb the DES algorithm in one of 4096 different ways, after 
which the password is used as the key to encrypt repeatedly a constant string. The returned value points to 
the encrypted password, in the same alphabet as the salt. The first two characters are the salt itself. 

The setkey and encrypt entries provide (rather primitive) access to the actual DES algorithm. The argument 
of setkey is a character array of length 64 containing only the characters with numerical value 0 and 1. If 
this string is divided into groups of 8, the low-order bit in each group is ignored, leading to a 56-bit key 
which is set into the machine. 

The argument to the encrypt entry is likewise a character array of length 64 containing O’s and I’s. The 
argument array is modified in place to a similar array representing the bits of the argument after having 
been subjected to the DES algorithm using the key set by setkey. If edflag is 0, the argument is encrypted; 
if non-zero, it is decrypted. 

SEE ALSO 

login(l), passwd(l), getpass(3C), passwd(5). 

BUGS 

The return value points to static data that are overwritten by each call. 
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NAME 

ctermid - generate file name for terminal 

SYNOPSIS 

#mclude <stdio h> 

char *ctermid(s) 
char *s; 

DESCRIPTION 

Ctermid generates a string that refers to the controlling terminal for the current process when used as a file 
name. 

If (int)^ is zero, the string is stored in an internal static area, the contents of which are overwritten at the 
next call to ctermid, and the address of which is returned. If (int).9 is non-zero, then s is assumed to point 
to a character array of at least L_cterinid elements; the string is placed in this array and the value of s is 
returned. The manifest constant L ctermid is defined in <stdio.h>. 

NOTES 

The difference between ctermid and ttynameQC) is that ttyname must be handed a file descriptor and 
returns the actual name of the terminal associated with that file descriptor, while ctermid returns a magic 
string (/dev/tty) that will refer to the terminal if used as a file name. Thus ttyname is useless unless the pro¬ 
cess already has at least one file open to a terminal. 

SEE ALSO 

ttyname(3C). 
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NAME 

isalpha, isupper, islower, isdigit, isxdigit, isalnum, isspace, ispunct, isprint, isgraph, iscntrl, isascii - charac¬ 
ter classification 

SYNOPSIS 

#mclude <ctype h> 

int isalpha (c) 
int c; 

DESCRIPTION 

These macros classify ASCII-coded integer values by table lookup. Each is a predicate returning nonzero 
for true, zero for false. Isascii is defined on all integer values; the rest are defined only where isascii is true 
and on the single non-ASCII value EOF (see stdio(3S)). 

isalpha c is a letter 

isupper c is an upper case letter 

islower c is a lower case letter 

isdigit c is a digit [0-9] 

isxdigit c is a hexidecimal digit [0-9], [A-F] or [a-f] 

isalnum c is an alphanumeric 

isspace c is a space, tab, carriage return, new-line, vertical tab, or form-feed 

ispunct c is a punctuation character (neither control nor alphanumeric) 

isprint c is a printing character, code 040 (space) through 0176 (tilde) 

isgraph c is a printing character, like isprint except false for space 

iscntrl c is a delete character (0177) or ordinary control character (less than 040). 

isascii c is an ASCII character, code less than 0200 

SEE ALSO 

ascii(7). 
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NAME 

cuserid - character login name of the user 

SYNOPSIS 

#mclude <stdio h> 

char *cuserid (s) 
char *s; 

DESCRIPTION 

Cuserid generates a character representation of the login name of the owner of the current process. If (int)^ 
is zero, this representation is generated in an internal static area, the address of which is returned. If (int)^ 
is non-zero, s is assumed to point to an array of at least L_cuserid characters; the representation is left in 
this array. The manifest constant L_cuserid is defined in <stdio.h>. 

DIAGNOSTICS 

If the login name cannot be found, cuserid returns NULL; if s is non-zero in this case, \0 will be placed at 
SEE ALSO 

getlogin(3C), getpwuid(3C). 

BUGS 

Cuserid uses getpwnam(3Cy, thus the results of a user’s call to the latter will be obliterated by a subsequent 
call to the former. 

The name cuserid is rather a misnomer. 
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NAME 

ecvt, fcvt - output conversion 
SYNOPSIS 

char *ecvt (value, ndigit, decpt, sign) 

double value; 

int ndigit, *decpt, *sign; 

char *fcvt (value, ndigit, decpt, sign) 

double value; 

int ndigit, *decpt, *sign; 

char *gcvt (value, ndigit, buf) 
double value; 
char *buf; 

DESCRIPTION 

Ecvt converts the value to a null-terminated string of ndigit ASCII digits and returns a pointer thereto. The 
position of the decimal point relative to the beginning of the string is stored indirectly through decpt (nega¬ 
tive means to the left of the returned digits). If the sign of the result is negative, the word pointed to by sign 
is non-zero, otherwise it is zero. The low-order digit is rounded. 

Fcvt is identical to ecvt, except that the correct digit has been rounded for Fortran F-format output of the 
number of digits specified by ndigits. 

Gcvt converts the value to a null-terminated ASCII string in buf and returns a pointer to buf. It attempts to 
produce ndigit significant digits in Fortran F format if possible, otherwise E format, ready for printing. 
Trailing zeros may be suppressed. 

SEE ALSO 

printf(3S). 

BUGS 

The return values point to static data whose content is overwritten by each call. 
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NAME 

end, etext, edata - last locations in program 

SYNOPSIS 

extern end; 
extern etext; 
extern edata; 

DESCRIPTION 

These names refer neither to routines nor to locations with interesting contents. The address of etext is the 
first address above the program text, edata above the initialized data region, and end above the uninitialized 
data region. 

When execution begins, the program break coincides with end, but the program break may be reset by the 
routines of brk(2), mallocQC), standard input/output (stdio(3S)), the profile (-p) option of cc{l), and so 
on. Thus, the current value of the program break should be determined by “sbrk(O)” (see brk(2)). 

These symbols are accessible from assembly language if it is remembered that they should be prefixed by _. 

SEE ALSO 

brk(2), malloc(3C). 
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NAME 

exp, log, pow, sqrt - exponential, logarithm, power, square root functions 

SYNOPSIS 

#mclude <math.h> 

double exp (x) 
double x; 

double log (x) 
double x; 

double pow (x, y) 
double X, y; 

double sqrt (x) 
double x; 

DESCRIPTION 

Exp returns the exponential function of x. 

Log returns the natural logarithm of x. 

Pow returns x'. 

Sqrt returns the square root of x. 

SEE ALSO 

intro(2), hypot(3M), sinh(3M). 

DIAGNOSTICS 

Exp and pow return a huge value when the correct value would overflow. A truly outrageous argument 
may also result in errno being set to ERANGE. 

Log returns a huge negative value and sets errno to EDOM when x is non-positive. 

Pow returns a huge negative value and sets errno to EDOM when x is non-positive and y is not an integer, 
or when x and y are both zero. 

Sqrt returns 0 and sets errno to EDOM when x is negative. 
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NAME 

fclose, fflush - close or flush a stream 

SYNOPSIS 

#mclude <stdio h> 

int fclose (stream) 

FILE ^stream; 

int fflush (stream) 

FILE *stream; 

DESCRIPTION 

Fclose causes any buffers for the named stream to be emptied, and the file to be closed. Buffers allocated 
by the standard input/output system are freed. 

Fclose is performed automatically upon calling exit{2). 

Fflush causes any buffered data for the named output stream to be written to that file. The stream remains 
open. 

These functions return 0 for success, and EOF if any errors were detected. 

SEE ALSO 

close(2), fopen(3S), setbuf(3S). 
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NAME 

ferror, feof, clearerr, fileno - stream status inquiries 

SYNOPSIS 

#mclude <stdio h> 

int feof (stream) 

FILE ^stream; 

int ferror (stream) 

FILE ^stream 

clearerr (stream) 

FILE *stream 

flleno(stream) 

FILE ^stream; 

DESCRIPTION 

Feof returns non-zero when end of file is read on the named input stream, otherwise zero. 

Ferror returns non-zero when error has occurred reading or writing the named stream, otherwise zero. 
Unless cleared by clearerr, the error indication lasts until the stream is closed. 

Clearerr resets the error indication on the named stream. 

Fileno returns the integer file descriptor associated with the stream, see open{2). 

Feof , ferror, Sind fileno are implemented as macros; they cannot be re-declared. 

SEE ALSO 

open(2), fopen(3S). 
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NAME 

floor, fabs, ceil, fmod - absolute value, floor, ceiling, remainder functions 

SYNOPSIS 

#mclude <math.h> 

double floor (x) 
double x; 

double ceil (x) 
double x; 

double fmod (x, y) 
double X, y; 

double fabs (x) 
double x; 

DESCRIPTION 

Fabs returns \ x \ . 

Floor returns the largest integer (as a double precision number) not greater than a:. 
Ceil returns the smallest integer not less than x. 

Fmod returns the number/ such that x = iy + f, for some integer /, and 
0<f<y. 

SEE ALSO 

abs(3C). 
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NAME 

fopen, freopen, fdopen - open a stream 

SYNOPSIS 

#mclude <stdio h> 

FILE *fopen (file-name, type) 
char *file-name, *type; 

FILE *freopen (file-name, type, stream) 
char *file-name, *type; 

FILE ^stream; 

FILE *fdopen (hides, type) 
int hides; 
char *type; 

DESCRIPTION 

Fopen opens the file named by file-name and associates a stream with it. Fopen returns a pointer to be 
used to identify the stream in subsequent operations. 

Type is a character string having one of the following values: 

"r" open for reading 

"w" create for writing 

"a" append; open for writing at end of file, or create for writing 

"r+" open for update (reading and writing) 

"w-i-" create for update 

"a+" append; open or create for update at end of file 

Freopen substitutes the named file in place of the open stream. It returns the original value of stream. The 
original stream is closed, regardless of whether the open ultimately succeeds. 

Freopen is typically used to attach the preopened constant names stdln, stdout, and stderr to specified 
files. 

Fdopen associates a stream with a file descriptor obtained from open, dup, creat, or pipe{2). The type of 
the stream must agree with the mode of the open file. 

When a file is opened for update, both input and output may be done on the resulting stream. However, 
output may not be directly followed by input without an interveningor rewind, and input may not be 
directly followed by output without an intervening rewind, or an input operation which encounters 
end of file. 

SEE ALSO 

open(2), fclose(3S). 

DIAGNOSTICS 

Fopen and freopen return the pointer NULL if file-name cannot be accessed. 
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NAME 

fptrap - floating point interpreter 
SYNOPSIS 

sys signal; 4; fptrap 
DESCRIPTION 

Fptrap is a simulator of the 11/45 FPll-B floating point unit. It works by intercepting illegal instruction 
traps and decoding and executing the floating point operation codes. 

Fptrap is not supported under the UNIX 3.0 system; it is included only to ease conversion to other 
machines. 

FILES 

There is a fake routine in /lib/libc.a with this name; when simulation is desired, the real version should be 
put in /lib/libc.a. 

SEE ALSO 

cc(l) (-f option), signal(2). 

DIAGNOSTICS 

A breakpoint trap is given when a real illegal instruction trap occurs. 

BUGS 

Rounding mode is not interpreted. It’s slow. 
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NAME 

fread, fwrite - buffered binary input/output 

SYNOPSIS 

#mclude <stdio h> 

int fread ((char *) ptr, sizeof (*ptr), niteins, stream) 

FILE ^stream; 

int fwrite ((char *) ptr, sizeof (*ptr), nitems, stream) 

FILE ^stream; 

DESCRIPTION 

Fread reads, into a block beginning at ptr, nitems of data of the type of *ptr from the named input stream. 
It returns the number of items actually read. 

Fwrite appends at most nitems of data of the type of *ptr beginning at ptr to the named output stream. It 
returns the number of items actually written. 

SEE ALSO 

read(2), write(2), fopen(3S), getc(3S), putc(3S), gets(3S), puts(3S), printf(3S), scanf(3S). 
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NAME 

frexp, Idexp, modf- split into mantissa and exponent 
SYNOPSIS 

double frexp (value, eptr) 
double value; 
int *eptr; 

double Idexp (value, exp) 
double value; 

double modf (value, iptr) 
double value, *iptr; 

DESCRIPTION 

Frexp returns the mantissa of a double value as a double quantity, x, of magnitude less than 1 and stores an 
integer n such that value = x*2**n indirectly through eptr. 

Ldexp returns the quantity value*2**exp. 

Modf returns the positive fractional part of value and stores the integer part indirectly through iptr. 
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NAME 

fseek, ftell, rewind - reposition a stream 

SYNOPSIS 

#mclude <stdio h> 

int fseek (stream, offset, ptrname) 

FILE ^stream; 
long offset; 
int ptrname; 

long ftell (stream) 

FILE ^stream; 

rewind(stream) 

FILE ^stream; 

DESCRIPTION 

Fseek sets the position of the next input or output operation on the stream. The new position is at the 
signed distance ojfset bytes from the beginning, the current position, or the end of the file, according as 
ptrname has the value 0, 1, or 2. 

Fseek undoes any effects of ungetc{'iS). 

After fseek or rewind, the next operation on an update file may be either input or output. 

Ftell returns the current value of the offset relative to the beginning of the file associated with the named 
stream. The offset is measured in bytes on UNIX 3.0 and UNIX/RT; on some other systems, it is a magic 
cookie and is the only foolproof way to obtain an offset for fseek. 

Rewind{stream) is equivalent to fseek{stream, OL, 0). 

SEE ALSO 

lseek(2), fopen(3S). 

DIAGNOSTICS 

Fseek returns non-zero for improper seeks, otherwise zero. 
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NAME 

gamma - log gamma function 

SYNOPSIS 

#include <math.h> 
extern int signgam; 

double gamma (x) 
double x; 

DESCRIPTION 

Gamma returns I r( I x I ) I . The sign of r( I x I ) is returned in the external integer signgam. The fol¬ 
lowing C program fragment might be used to calculate F: 

y = gamma (x); 
if (y > 88.0) 

error (); 

y = exp (y) * signgam; 

DIAGNOSTICS 

For negative integer arguments, a huge value is returned, and errno is set to EDOM. 
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NAME 

getc, getchar, fgetc, getw - get character or word from stream 

SYNOPSIS 

#include <stdio h> 

int getc (stream) 

FILE ^stream; 

int getchar () 

int fgetc (stream) 

FILE ^stream; 

int getw (stream) 

FILE ^stream; 

DESCRIPTION 

Getc returns the next character from the named input stream. 

GetcharQ is identical to getc{stdin). 

Fgetc behaves like getc, but is a genuine function, not a macro; it may therefore be used as an argument. 
Fgetc runs more slowly than getc, but takes less space per invocation. 

G^fw returns the next word from the named input stream. It returns the constant EOF upon end of file or 
error, but since that is a valid integer value, feof and ferror(3S) should be used to check the success of 
getw. Getw assumes no special alignment in the file. 

SEE ALSO 

ferror(3S), fopen(3S), fread(3S), gets(3S), putc(3S), scanf(3S). 

DIAGNOSTICS 

These functions return the integer constant EOF at end of file or upon read error. 

A stop with message “Reading bad file” means that an attempt has been made to read from a stream that 
has not been opened for reading by fopen. 

BUGS 

Getc and its variant getchar return EOF on end of file; this is wiser than, but incompatible with, the older 
getchar(3S>). 

Because it is implemented as a macro, getc treats incorrectly a stream argument with side effects. In par¬ 
ticular, getc(*f++); doesn’t work sensibly. 
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NAME 

getenv - value for environment name 

SYNOPSIS 

char *getenv (name) 
char *name; 

DESCRIPTION 

Getenv searches the environment list (see environil)) for a string of the form name=value and returns 
value if such a string is present, otherwise 0 (NULL). 

SEE ALSO 

environ(7). 
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NAME 

getlogin - get login name 

SYNOPSIS 

char ^getlogin (); 

DESCRIPTION 

Getlogin returns a pointer to the login name as found in /etc/utmp. It may be used in conjunction with 
getpwnam to locate the correct password file entry when the same user ID is shared by several login names. 

If getlogin is called within a process that is not attached to a typewriter, it returns NULL. The correct pro¬ 
cedure for determining the login name is to call cuserid, or to call getlogin and if it fails, to call getpwuid. 

FILES 

/etc/utmp 
SEE ALSO 

cuserid(3S), getgrent(3C), getpwent(3C), utmp(5). 

DIAGNOSTICS 

Returns NULL if name not found. 

BUGS 

The return values point to static data whose content is overwritten by each call. 
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NAME 

getopt - get option letter from argv 
SYNOPSIS 

int getopt (argc, argv, optstring) 

int argc; 

char **argv; 

char *optstring; 

extern char *optarg; 

extern int optind; 

DESCRIPTION 

Getopt returns the next option letter in argv that matches a letter in optstring. Optstring is a string of rec¬ 
ognized option letters; if a letter is followed by a colon, the option is expected to have an argument that 
may or may not be separated from it by white space. Optarg is set to point to the start of the option argu¬ 
ment on return from getopt. 

Getopt places in optind the argv index of the next argument to be processed. Because optind is external, it 
is normally initialized to zero automatically before the first call to getopt. 

When all options have been processed (i.e., up to the first non-option argument), getopt returns EOF. The 
special option — may be used to delimit the end of the options; EOF will be returned, and — will be 
skipped. 

DIAGNOSTICS 

Getopt prints an error message on stderr and returns a question mark (?) when it encounters an option let¬ 
ter not included in optstring. 

EXAMPLE 

The following code fragment shows how one might process the arguments for a command that can take the 
mutually exclusive options a and b, and the options f and o, both of which require arguments: 

main (argc, argv) 
int argc; 
char **argv; 

{ 

int c; 

extern int optind; 
extern char *optarg; 


while ((c = getopt (argc, argv, "abf:o:")) != EOF) 
switch (c) { 
case 'a': 

if (bflg) 

errflg-i-+; 

else 

aflg++; 

break; 

case 'b': 


if (aflg) 

else 

break; 

case T: 


errflg-i-+; 

bproc(); 


ifile = optarg; 
break; 
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case 'o': 

ofile = optarg; 
bufsiza = 512; 
break; 

case '?': 

erTflg++; 


if (errflg) { 

fprintf (stderr, "usage: . . . "); 
exit (2); 

1 

for( ; optind < argc; optind++) { 

if (access (argv[optind], 4)) { 
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NAME 

getpass - read a password 
SYNOPSIS 

char *getpass (prompt) 
char ^prompt; 

DESCRIPTION 

Getpass reads a password from the file /dev/tty, or if that cannot be opened, from the standard input, after 
prompting with the null-terminated string prompt and disabling echoing. A pointer is returned to a null- 
terminated string of at most 8 characters. 

FILES 

/dev/tty 

SEE ALSO 

cryptOC). 

BUGS 

The return value points to static data whose content is overwritten by each call. 
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NAME 

getpw - get name from UID 

SYNOPSIS 

getpw (uid, buf) 
int uid; 
char *buf; 

DESCRIPTION 

Getpw searches the password file for the (numerical) uid, and fills in buf with the corresponding line; it 
returns non-zero if uid could not be found. The line is null-terminated. 

This routine is included only for compatibility with prior systems and should not be used; see getpwent{?>C) 
for routines to use instead. 

FILES 

/etc/passwd 
SEE ALSO 

getpwent(3C), passwd(5). 

DIAGNOSTICS 

Non-zero return on error. 
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NAME 

gets, fgets - get a string from a stream 

SYNOPSIS 

#mclude <stdio h> 

char *gets (s) 
char *s; 

char *fgets (s, n, stream) 
char *s; 
int n; 

FILE ^stream; 

DESCRIPTION 

Gets reads a string into s from the standard input stream stdin. The string is terminated by a new-line char¬ 
acter, which is replaced in ^ by a null character. Gets returns its argument. 

Fgets reads n-\ characters, or up to a new-line character (which is retained), whichever comes first, from 
the stream into the string s. The last character read into s is followed by a null character. Fgets returns its 
first argument. 

SEE ALSO 

ferror(3S), fopen(3S), fread(3S), getc(3S), puts(3S), scanf(3S). 

DIAGNOSTICS 

Gets md fgets return the constant pointer NULL upon end-of-file or error. 

NOTE 

Gets deletes the new-line ending its input, h\xi fgets keeps it. 
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NAME 

hypot - Euclidean distance 

SYNOPSIS 

#mclude <math.h> 

double hypot (x, y) 
double X, y; 

DESCRIPTION 

Hypot returns 

sqrt(x*x + y*y), 

taking precautions against unwarranted overflows. 

SEE ALSO 

sqrt(3M). 
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NAME 

13tol, ltol3 - convert between 3-byte integers and long integers 

SYNOPSIS 

l3tol (Ip, cp, n) 
long *lp; 
char *cp; 
int n; 

ltol3 (cp, Ip, n) 
char *cp; 
long *lp; 
int n; 

DESCRIPTION 

L3tol converts a list of n three-byte integers packed into a character string pointed to by cp into a list of 
long integers pointed to by Ip. 

Ltol3 performs the reverse conversion from long integers {Ip) to three-byte integers {cp). 

These functions are useful for file-system maintenance where the block numbers are three bytes long. 

SEE ALSO 

fs(5). 
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NAME 

logname - login name of user 

SYNOPSIS 

char *lognaine(); 

DESCRIPTION 

Logname returns a pointer to the null-terminated login name; it extracts the SLOGNAME variable from the 
user’s environment. 

This routine is kept in /lib/libPW.a. 

FILES 

/etc/profile 
SEE ALSO 

env(l), login(l), profile(5), environ(7). 
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NAME 

Isearch - linear search and update 
SYNOPSIS 

char *lsearch (key, base, nelp, width, compar) 

char *key; 

char *base; 

int *nelp; 

int width; 

int (*compar)(); 

DESCRIPTION 

Lsearch is a linear search routine generalized from Knuth (6.1) Algorithm Q. It returns a pointer into a 
table indicating the location at which a datum may be found. If the item does not occur, it is added at the 
end of the table. The first argument is a pointer to the datum to be located in the table. The second argu¬ 
ment is a pointer to the base of the table. The third is the address of an integer containing the number of 
items in the table. It is incremented if the item is added to the table. The fourth is the width of an element 
in bytes. The last is the name of the comparison routine. It is called with two arguments which are pointers 
to the elements being compared. The routine must return zero if the items are equal and non-zero other¬ 
wise. 


BUGS 

Unpredictable events can occur if there is not enough room in the table to add a new item. 
SEE ALSO 

bsearch(3C), qsort(3C). 
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NAME 

malloc, free, realloc, calloc - main memory allocator 
SYNOPSIS 

char *malloc (size) unsigned size; 

free (ptr) 
char *ptr; 

char *realloc (ptr, size) 
char *ptr; 
unsigned size; 

char *calloc (nelem, elsize) 
unsigned elem, elsize; 

DESCRIPTION 

Malloc Sind free provide a simple general-purpose memory allocation package. Malloc returns a pointer to 
a block of at least size bytes beginning on a word boundary. 

The argument to free is a pointer to a block previously allocated by malloc ; this space is made available for 
further allocation, but its contents are left undisturbed. 

Needless to say, grave disorder will result if the space assigned by malloc is overrun or if some random 
number is handed lo free. 

Malloc allocates the first big enough contiguous reach of free space found in a circular search from the last 
block allocated or freed, coalescing adjacent free blocks as it searches. It calls sbrk (see hrk(2)) to get more 
memory from the system when there is no suitable space already free. 

Realloc changes the size of the block pointed to by ptr to size bytes and returns a pointer to the (possibly 
moved) block. The contents will be unchanged up to the lesser of the new and old sizes. 

Realloc also works if ptr points to a block freed since the last call of malloc, realloc, or calloc, thus 
sequences of free, malloc and realloc can exploit the search strategy of malloc to do storage compaction. 

Calloc allocates space for an array of nelem elements of size elsize. The space is initialized to zeros. 

Each of the allocation routines returns a pointer to space suitably aligned (after possible pointer coercion) 
for storage of any type of object. 

DIAGNOSTICS 

Malloc, realloc and calloc return a null pointer (0) if there is no available memory or if the arena has been 
detectably corrupted by storing outside the bounds of a block. When realloc returns 0, the block pointed to 
by ptr may be destroyed. 
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NAME 

mktemp - make a unique file name 
SYNOPSIS 

char *mktemp (template) 
char ^template; 

DESCRIPTION 

Mktemp replaces template by a unique file name, and returns the address of the template. The template 
should look like a file name with six trailing Xs, which will be replaced with a letter and the current process 
ID. The letter will be chosen so that the resulting name does not duplicate an existing file. 

SEE ALSO 

getpid(2). 

BUGS 

It is possible to run out of letters. 
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NAME 

monitor - prepare execution profile 
SYNOPSIS 

monitor (lowpc, highpc, buffer, bufsize, nfunc) 
int (*lowpc)(), (*highpc)(); 
short buffer[]; 
int bufsize, nfunc; 

DESCRIPTION 

An executable program created by cc -p automatically includes calls for monitor with default parameters; 
monitor needn’t be called explicitly except to gain fine control over profiling. 

Monitor is an interface to profil(2). Lowpc and highpc are the addresses of two functions; buffer is the 
address of a (user supplied) array of bufsize short integers. Monitor arranges to record a histogram of peri¬ 
odically sampled values of the program counter, and of counts of calls of certain functions, in the buffer. 
The lowest address sampled is that of lowpc and the highest is just below highpc. At most nfunc call 
counts can be kept; only calls of functions compiled with the profiling option -p of cc(l) are recorded. For 
the results to be significant, especially where there are small, heavily used routines, it is suggested that the 
buffer be no more than a few times smaller than the range of locations sampled. 

To profile the entire program, it is sufficient to use 
extern etext(); 

monitor(2, etext, buf, bufsize, nfunc); 

Etext lies just above all the program text, see end(3C). 

To stop execution monitoring and write the results on the file mon.out, use 
monitor(O); 

prof(\) can then be used to examine the results. 

FILES 

mon.out 
SEE ALSO 

cc(l), prof(l), profil(2). 
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NAME 

nlist - get entries from name list 

SYNOPSIS 

#mclude <a.out h> 
nlist (file-name, nl) 
char *file-name; 
struct nlist nl[ ]; 

DESCRIPTION 

Nlist examines the name list in the given executable output file and selectively extracts a list of values. The 
name list consists of an array of structures containing names, types and values. The list is terminated with a 
null name. Each name is looked up in the name list of the file. If the name is found, the type and value of 
the name are inserted in the next two fields. If the name is not found, both entries are set to 0. See a.out(5) 
for a discussion of the symbol table structure. 

This subroutine is useful for examining the system name list kept in the file /unix. In this way programs 
can obtain system addresses that are up to date. 

SEE ALSO 

a.out(5). 

DIAGNOSTICS 

All type entries are set to 0 if the file cannot be found or if it is not a valid namelist. 
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NAME 

perror, sys_erTlist, sys_nerr, errno - system error messages 

SYNOPSIS 

perror (s) 
char *s; 

int sysnerr; 
char *sys_errlist[ ]; 

int errno; 

DESCRIPTION 

Perror produces a short error message on the standard error, describing the last error encountered during a 
system call from a C program. First the argument string 5 is printed, then a colon, then the message and a 
new-line. To be of most use, the argument string should be the name of the program that incurred the error. 
The error number is taken from the external variable errno, which is set when errors occur but not cleared 
when non-erroneous calls are made. 

To simplify variant formatting of messages, the vector of message strings sys_errlist is provided; errno can 
be used as an index in this table to get the message string without the new-line. Sysjierr is the largest mes¬ 
sage number provided for in the table; it should be checked because new error codes may be added to the 
system before they are added to the table. 

SEE ALSO 

intro(2). 
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NAME 

plot - graphics interface subroutines 

SYNOPSIS 

openpl0 

erase () 

label (s) 
char *s; 

line (xl, yl, x2, y2) 
circle (x, y, r) 
arc (x, y, xO, yO, xl, 
move (x, y) 
cont (x, y) 
point (x, y) 

linemod (s) 
char *s; 

space (xO, yO, xl, yl) 
closepi 0 
DESCRIPTION 

These subroutines generate graphic output in a relatively device-independent manner. See plot{5) for a 
description of their effect. Openpl must be used before any of the others to open the device for writing. 
Closepi flushes the output. 

String arguments to label and linemod are terminated by nulls and do not contain new-lines. 

The library files listed below provide several flavors of these routines. 

FILES 

/usr/lib/libplot.a produces output for tplot{\G) filters 
/usr/lib/lib300.a for DASI 300 
/usr/lib/lib300s.a for DASI 300s 
/usr/lib/lib450.a for DASI 450 
/usr/lib/lib4014.a for Tektronix 4014 

SEE ALSO 

graph(lG), tplot(lG), plot(5). 
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NAME 

popen, pclose - initiate I/O to/from a process 

SYNOPSIS 

#mclude <stdio h> 

FILE *popen (command, type) 
char ^command, *type; 

int pclose (stream) 

FILE ^stream; 

DESCRIPTION 

The arguments to popen are pointers to null-terminated strings containing, respectively, a shell command 
line and an I/O mode, either r for reading or w for writing. Popen creates a pipe between the calling pro¬ 
cess and the command to be executed. The value returned is a stream pointer that can be used (as appropri¬ 
ate) to write to the standard input of the command or read from its standard output. 

A stream opened by popen should be closed by pclose, which waits for the associated process to terminate 
and returns the exit status of the command. 

Because open files are shared, a type r command may be used as an input filter, and a type w as an output 
filter. 

SEE ALSO 

pipe(2), wait(2), fclose(3S), fopen(3S), system(3S). 

DIAGNOSTICS 

Popen returns a null pointer if files or processes cannot be created, or if the shell cannot be accessed. 

Pclose returns -1 if stream is not associated with a "‘popen ed"' command. 

BUGS 

Only one stream opened by popen can be in use at once. 

Buffered reading before opening an input filter may leave the standard input of that filter mispositioned. 
Similar problems with an output filter may be forestalled by careful buffer flushing, e.g. withj^n^/i; see 
fclose{3S). 
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NAME 

printf, fprintf, sprintf - output formatters 

SYNOPSIS 

#mclude <stdio h> 

int printf (format [, arg ] ... ) 
char ^format; 

int fprintf (stream, format [, arg ] ... ) 

FILE *stream; 
char ^format; 

int sprintf (s, format [, arg ] ... ) 
char *s, format; 

DESCRIPTION 

Printf places output on the standard output stream stdout. Fprintf places output on the named output 
stream. Sprintf places “output”, followed by the null character (\0) in consecutive bytes starting at * 5 ; it is 
the user’s responsibility to ensure that enough storage is available. Each function returns the number of 
characters transmitted (not including the \0 in the case of sprintf), or a negative value if an output error was 
encountered. 

Each of these functions converts, formats, and prints its args, under control of the format. The format is a 
character string that contains two types of objects: plain characters, which are simply copied to the output 
stream, and conversion specifications, each of which results in fetching of zero or more args,. The results 
are undefined if there are insufficient args, for the format. If the format is exhausted while args remain, the 
excess args are simply ignored. 

Each conversion specification is introduced by the character %. After the %, the following appear in 
sequence: 

Zero or more flags, which modify the meaning of the conversion specification. 

An optional decimal digit string specifying a minimum width. If the converted value has 
fewer characters than the field width, it will be padded on the left (or right, if the left-adjustment 
flag (see below) has been given) to the field width; 

A precision that gives the minimum number of digits to appear for the d, o, u, x, or X conver¬ 
sions, the number of digits to appear after the decimal point for the e and f conversions, the maxi¬ 
mum number of significant digits for the g conversion, or the maximum number of characters to be 
printed from a string in s conversion. The precision takes the form of a period (.) followed by a 
decimal digit string: a null digit string is treated as zero. 

An optional 1 specifying that a following d, o, u, x, or X conversion character applies to a long 
integer arg. 

A character that indicates the type of conversion to be applied. 

A field width or precision may be indicated by an asterisk (*) instead of a digit string. In this case, an inte¬ 
ger arg supplies the field width or precision. The arg that is actually converted is not fetched until the con¬ 
version letter is seen, so the args specifying field width or precision must appear before the arg (if any) to 
be converted. 

The flag characters and their meanings are: 

- The result of the conversion will be left-justified within the field. 

+ The result of a signed conversion will always begin with a sign (+ or -). 

blank If the first character of a signed conversion is not a sign, a blank will be prepended to the result. 

This implies that if the blank and + flags both appear, the blank flag will be ignored. 

# This flag specifies that the value is to be converted to an “alternate form.” For c, d, s, and u 

conversions, the flag has no effect. For o conversion, it increases the precision to force the first 
digit of the result to be a zero. For x (X) conversion, a non-zero result will have Ox (OX) 
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prepended to it. For e, E, f, g, and G conversions, the result will always contain a decimal 
point, even if no digits follow the point (normally, a decimal point appears in the result of these 
conversions only if a digit follows it). For g and G conversions, trailing zeroes will not be 
removed from the result (which they normally are). 

The conversion characters and their meanings are: 

d, o,u,x,X The integer arg is converted to signed decimal, unsigned octal, decimal, or hexadecimal nota¬ 

tion (x and X), respectively; the letters abcdef are used for x conversion and the letters 
ABCDEF for X conversion. The precision specifies the minimum number of digits to appear; if 
the value being converted can be represented in fewer digits, it will be expanded with leading 
zeroes. The default precision is 1. The result of converting a zero value with a precision of 
zero is a null string (unless the conversion is o, x, or X and the # flag is present), 
f The float or double arg is converted to decimal notation in the style “[-Jddd.ddd”, where the 

number of digits after the decimal point is equal to the precision specification. If the precision 
is missing, 6 digits are output; if the precision is explicitly 0, no decimal point appears. 

e, E The float or double arg is converted in the style “[-]d.ddde±dd”, where there is one digit 

before the decimal point and the number of digits after it is equal to the precision; when the 
precision is missing, 6 digits are produced; if the precision is zero, no decimal point appears. 
The E format code will produce a number with E instead of e introducing the exponent. The 
exponent always contains exactly two digits. 

g,G The float or double arg is printed in style f or e (or in style E in the case of a G format code), 

with the precision specifying the number of significant digits. The style used depends on the 
value converted: style e will be used only if the exponent resulting from the conversion is less 
than -4 or greater than the precision. Trailing zeroes are removed from the result; a decimal 
point appears only if it is followed by a digit, 
c The character arg is printed. 

s The arg is taken to be a string (character pointer) and characters from the string are printed 

until a null character (\0) is encountered or the number of characters indicated by the precision 
specification is reached. If the precision is missing, it is taken to be infinite, so all characters 
up to the first null character are printed. 

% Print a %; no argument is converted. 

In no case does a non-existent or small field width cause truncation of a field; if the result of a conversion is 
wider than the field width, the field is simply expanded to contain the conversion result. Characters gener¬ 
ated by print/ ‘dnd/print/ are printed as if putchar had been called (see putcQS)). 

EXAMPLES 

To print a date and time in the form “Sunday, July 3, 10:02”, where weekday and month are pointers to 
null-terminated strings: 

printf("%s, %s %d, %.2d:%.2d", weekday, month, day, hour, min); 

To print tt to 5 decimal places: 

printfC'pi = %.5f’, 4*atan(1.0)); 

SEE ALSO 

ecvt(3C), putc(3S), scanf(3S), stdio(3S). 
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NAME 

putc, putchar, fputc, putw - put character or word on a stream 

SYNOPSIS 

#mclude <stdio h> 

int putc (c, stream) 
char c; 

FILE ^stream; 
putchar (c) 

fputc (c, stream) 

FILE ^stream; 

putw (w, stream) 
int w; 

FILE ^stream; 

DESCRIPTION 

Putc appends the character c to the named output stream. It returns the character written. 

Putchar{c) is defined as putc{c, stdout). 

Fputc behaves like putc, but is a genuine function rather than a macro; it may therefore be used as an argu¬ 
ment. Fputc runs more slowly than putc, but takes less space per invocation. 

Putw appends the word (i.e., integer) w to the output stream. Putw neither assumes nor causes special 
alignment in the file. 

The standard stream stdout is normally buffered if and only if the output does not refer to a terminal; this 
default may be changed by setbuf(3S). The standard stream stderr is by default unbuffered uncondition¬ 
ally, but use offreopen(3S) will cause it to become unbuffered; sethuf, again, will set the state to whatever 
is desired. When an output stream is unbuffered information appears on the destination file or terminal as 
soon as written; when it is buffered many characters are saved up and written as a block. See also 
jflushOS). 

SEE ALSO 

ferror(3S), fopen(3S), fwrite(3S), getc(3S), printf(3S), puts(3S). 

DIAGNOSTICS 

These functions return the constant EOF upon error. Since this is a good integer,/error(3S) should be used 
to detect putw errors. 

BUGS 

Because it is implemented as a macro, putc treats incorrectly a stream argument with side effects. In par¬ 
ticular, putc(c, *f++); doesn’t work sensibly. 
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NAME 

putpwent - write password file entry 

SYNOPSIS 

#mclude <pwd h> 

int putpwent (p, f) 
struct passwd *p; 

FILE ^f; 

DESCRIPTION 

Putpwent is the inverse of getpwenti^C). Given a pointer to a passwd structure created by getpwent (or 
getpwuid(3C) or getpwnam(3C)), putpwuid writes a line on the stream / which matches the format of 

/etc/pass wd. 

DIAGNOSTICS 

Putpwent returns non-zero if an error was detected during its operation, otherwise zero. 
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NAME 

puts, fputs - put a string on a stream 

SYNOPSIS 

#mclude <stdio h> 

int puts (s) 
char *s; 

int fputs (s, stream) 
char *s; 

FILE ^stream; 

DESCRIPTION 

Puts copies the null-terminated string 5 to the standard output stream stdout and appends a new-line char¬ 
acter. 

Fputs copies the null-terminated string s to the named output stream. 

Neither routine copies the terminating null character. 

DIAGNOSTICS 

Both routines return EOF on error. 

SEE ALSO 

ferror(3S), fopen(3S), fwrite(3S), gets(3S), printf(3S), putc(3S). 

NOTES 

Puts appends a new-line, fputs does not. 
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NAME 

qsort - quicker sort 
SYNOPSIS 

qsort (base, nel, width, compar) 
char *base; 
int nel, width; 
int (*compar)(); 

DESCRIPTION 

Qsort is an implementation of the quicker-sort algorithm. The first argument is a pointer to the base of the 
data; the second is the number of elements; the third is the width of an element in bytes; the last is the name 
of the comparison routine. It is called with two arguments which are pointers to the elements being com¬ 
pared. The routine must return an integer less than, equal to, or greater than 0 according as the first argu¬ 
ment is to be considered less than, equal to, or greater than the second. 

SEE ALSO 

sort(l), bsearch(3C), lsearch(3C), strcmp(3C). 
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NAME 

rand, srand - random number generator 

SYNOPSIS 

srand (seed) 
unsigned seed; 

rand () 

DESCRIPTION 

Rand uses a multiplicative congruential random number generator with period 2^^ to return successive 
pseudo-random numbers in the range from 0 to 

The generator is reinitialized by calling srand with 1 as argument. It can be set to a random starting point 
by calling srand with whatever you like as argument. 
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NAME 

regex, regcmp - regular expression compile/execute 
SYNOPSIS 

char *regcmp(stringl[,string2,.. .],0); 
char *stringl, *string2,.. 

char *regex(re,subject[,retO,...]); 
char *re, *subject, *retO,.. 

DESCRIPTION 

Regcmp compiles a regular expression and returns a pointer to the compiled form. Malloc(3C) is used to 
create space for the vector. It is the user’s responsibility to free unneeded space so allocated. A zero return 
from regcmp indicates an incorrect argument. Regcmp{\) has been written to generally preclude the need 
for this routine at execution time. 

Regex executes a compiled pattern against the subject string. Additional arguments are passed to receive 
values back. Regex returns zero on failure or a pointer to the next unmatched character on success. A glo¬ 
bal character pointer Joel points to where the match began. Regcmp and regex were mostly borrowed 
from the editor, ed{\) however, the syntax and semantics have been changed slightly. The following are 
the valid symbols and their associated meanings. 

[]*.'" These symbols retain their current meaning. 

$ Matches the end of the string, \n matches the new-line. 

- Within brackets the minus means through. For example, [a-z] is equivalent to [abcd...xyz]. 

The - can appear as itself only if used as the last or first character. For example, the character 
class expression []-] matches the characters ] and -. 

+ A regular expression followed by + means one or more times. For example, [0-9]+ is equivalent 

to [0-9][0-9]^. 

{m) {m,) {m,u) 

Integer values enclosed in (} indicate the number of times the preceding regular expression is to 
be applied, m is the minimum number and m is a number, less than 256, which is the maximum. 
If only m is present (e.g., {m}), it indicates the exact number of times the regular expression is to 
be applied, {m,} is analogous to {m,infinity}. The plus (+) and star (*) operations are equivalent 
to {!,} and {0,} respectively. 

(... )$n The value of the enclosed regular expression is to be returned. The value will be stored in the 
(n+1 )th. argument following the subject argument. At present, at most ten enclosed regular 
expressions are allowed. Regex makes its assignments unconditionally. 

(...) Parentheses are used for grouping. An operator, e.g. *, +, {}, can work on a single character or a 
regular expression enclosed in parenthesis. For example, (a*(cb+)*)$0. 

By necessity, all the above defined symbols are special. They must, therefore, be escaped to be used as 
themselves. 

EXAMPLES 

Example 1: 

char ^cursor, *newcursor, *ptr; 

newcursor = regex((ptr=regcmp("''\n",0)),cursor); 
free(ptr); 

This example will match a leading new-line in the subject string pointed at by cursor. 

Example 2: 

charret0[9]; 

char *newcursor, *name; 
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name = regcmp("([A-Za-z][A-za-z0-9_]{0,7})$0",0); 
newcursor = regex(name,” 123Testing321 ",retO); 

This example will match through the string ‘Testing3” and will return the address of the character after the 
last matched character (cursor+11). The string ‘Testing3” will be copied to the character array 

Example 3: 

#include "filed" 

char ^string, *newcursor; 

newcursor = regex(name,string); 

This example applies a precompiled regular expression in file i (see regcmp{\)) against string. 

This routine is kept in /lib/libPW.a. 

SEE ALSO 

ed(l), regcmp(l), free(3C), malloc(3C). 

BUGS 

The user program may run out of memory if regcmp is called iteratively without freeing the vectors no 
longer required. The following user-supplied replacement for malloc(3C) re-uses the same vector saving 
time and space; 

/* user’s program */ 

malloc(n) { 
static intrebuf[256]; 

return &rebuf; 
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NAME 

scanf, fscanf, sscanf - formatted input conversion 

SYNOPSIS 

#mclude <stdio h> 

scanf (format [, pointer ] ... ) 
char ^format; 

fscanf (stream, format [, pointer ] ... ) 

FILE *stream; 
char ^format; 

sscanf (s, format [ , pointer ] ... ) 
char *s, ^format; 

DESCRIPTION 

Scanf reads from the standard input stream stdin. Fscanf reads from the named input stream. Sscanf reads 
from the character string s. Each function reads characters, interprets them according to a format, and 
stores the results in its arguments. Each expects, as arguments, a control string format described below, 
and a set of pointer arguments indicating where the converted input should be stored. 

The control string usually contains conversion specifications, which are used to direct interpretation of 
input sequences. The control string may contain: 

1. Blanks, tabs, or new-lines, which cause input to be read up to the next non-white-space character. 

2. An ordinary character (not %), which must match the next character of the input stream. 

3. Conversion specifications, consisting of the character %, an optional assignment suppressing character 
*, an optional numerical maximum field width, and a conversion character. 

A conversion specification directs the conversion of the next input field; the result is placed in the variable 
pointed to by the corresponding argument, unless assignment suppression was indicated by *. An input 
field is defined as a string of non-space characters; it extends to the next inappropriate character or until the 
field width, if specified, is exhausted. 

The conversion character indicates the interpretation of the input field; the corresponding pointer argument 
must usually be of a restricted type. The following conversion characters are legal: 

% a single % is expected in the input at this point; no assignment is done, 

d a decimal integer is expected; the corresponding argument should be an integer pointer, 

o an octal integer is expected; the corresponding argument should be an integer pointer. 

X a hexadecimal integer is expected; the corresponding argument should be an integer pointer, 

s a character string is expected; the corresponding argument should be a character pointer pointing 

to an array of characters large enough to accept the string and a terminating \0, which will be 
added automatically. The input field is terminated by a space character or a new-line, 
c a character is expected; the corresponding argument should be a character pointer. The normal 

skip over space characters is suppressed in this case; to read the next non-space character, use 
%ls. If a field width is given, the corresponding argument should refer to a character array; the 
indicated number of characters is read. 

e,f a floating point number is expected; the next field is converted accordingly and stored through the 
corresponding argument, which should be a pointer to afloat. The input format for floating point 
numbers is an optionally signed string of digits, possibly containing a decimal point, followed by 
an optional exponent field consisting of an E or an e, followed by an optionally signed integer. 

[ indicates a string that is not to be delimited by space characters. The left bracket is followed by a 

set of characters and a right bracket; the characters between the brackets define a set of characters 
making up the string. If the first character is not a circumflex ("'), the input field consists of all 
characters up to the first character that is not in the set between the brackets; if the first character 
after the left bracket is a the input field consists of all characters up to the first character that is in 
the set of the remaining characters between the brackets. The corresponding argument must point 
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to a character array. 

The conversion characters d, o, and x may be capitalized and/or preceded by 1 to indicate that a pointer to 
long rather than to int is in the argument list. Similarly, the conversion characters e and f may be capital¬ 
ized and/or preceded by 1 to indicate that a pointer to double rather than to float is in the argument list. The 
character h will, some time in the future, indicate short data items. 

Scanf conversion terminates at EOF, at the end of the control string, or when an input character conflicts 
with the control string. In the latter case, the offending character is left unread in the input stream. 

Scanf returns the number of successfully matched and assigned input items; this number can be zero in the 
event of an early conflict between an input character and the control string. If the input ends before the first 
conflict or conversion, EOF is returned. 

EXAMPLES 

The call: 

int i; float x; char name[50]; 
scanf ("%d%f%s", &i, &x, name); 

with the input line: 

25 54.32E-1 thompson 

will assign to i the value 25, to x the value 5.432, and name will contain thompson\0. Or: 

int i; float x; char name[50]; 

scanf ("%2d%f%*d%[1234567890]", &i, &x, name); 

with input: 

56789 0123 56a72 

will assign 56 to /, 789.0 to x, skip 0123, and place the string 56\0 in name. The next call to getchar (see 
gerc(3S)) will return a. 

SEE ALSO 

atof(3C), getc(3S), printf(3S). 

NOTE 

Trailing white space (including a new-line) is left unread unless matched in the control string. 
DIAGNOSTICS 

These functions return EOF on end of input and a short count for missing or illegal data items. 

BUGS 

The success of literal matches and suppressed assignments is not directly determinable. 
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NAME 

setbuf - assign buffering to a stream 

SYNOPSIS 

#mclude <stdio h> 

setbuf (stream, buf) 

FILE ^stream; 
char *buf; 

DESCRIPTION 

Setbuf is used after a stream has been opened but before it is read or written. It causes the character array 
buf to be used instead of an automatically allocated buffer. If buf is the constant pointer NULL, 
input/output will be completely unbuffered. 

A manifest constant BUFSIZ tells how big an array is needed: 
char buf [BUFSIZ]; 

A buffer is normally obtained from malloc(3C) upon the first getc or putc(3S) on the file, except that out¬ 
put streams directed to terminals, and the standard error stream stderr are normally not buffered. 

A common source of error is allocation of buffer space as an “automatic” variable in a code block, and 
then failing to close the stream in the same block. 

SEE ALSO 

fopen(3S), getc(3S), malloc(3C), putc(3S). 
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NAME 

setjmp, longjmp - non-local goto 

SYNOPSIS 

#mclude <setjmp.h> 

int setjmp (env) 
jmpbuf env; 

longjmp (env, val) 
jmp buf env; 

DESCRIPTION 

These routines are useful for dealing with errors and interrupts encountered in a low-level subroutine of a 
program. 

Setjmp saves its stack environment in env for later use by longjmp. It returns value 0. 

Longjmp restores the environment saved by the last call of setjmp. It then returns in such a way that execu¬ 
tion continues as if the call of setjmp had just returned the value val to the corresponding call to setjmp, 
which must not itself have returned in the interim. Longjmp cannot return the value 0. If longjmp is 
invoked with a second argument of 0, it will return 1. All accessible data have values as of the time 
longjmp was called. 

SEE ALSO 

signal(2). 
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NAME 

sinh, cosh, tanh - hyperbolic functions 

SYNOPSIS 

#mclude <math.h> 

double sinh (x) 
double x; 

double cosh (x) 
double x; 

double tanh (x) 
double x; 

DESCRIPTION 

These functions compute the designated hyperbolic functions for real arguments. 
DIAGNOSTICS 

Sinh and cosh return a huge value of appropriate sign when the correct value would overflow. 
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NAME 

sleep - suspend execution for interval 
SYNOPSIS 

unsigned sleep (seconds) 
unsigned seconds; 

DESCRIPTION 

The current process is suspended from execution for the number of seconds specified by the argument. The 
actual suspension time may be less than that requested for two reasons: (1) Because scheduled wakeups 
occur at fixed 1-second intervals, and (2) because any caught signal will terminate the sleep following exe¬ 
cution of that signal’s catching routine. Also, the suspension time may be longer than requested by an arbi¬ 
trary amount due to the scheduling of other activity in the system. The value returned by sleep will be the 
“unslept” amount (the requested time minus the time actually slept) in case the caller had an alarm set to 
go off earlier than the end of the requested sleep time, or premature arousal due to another caught signal. 

The routine is implemented by setting an alarm signal and pausing until it (or some other signal) occurs. 
The previous state of the alarm signal is saved and restored. The calling program may have set up an alarm 
signal before calling sleep ; if the sleep time exceeds the time till such alarm signal, the process sleeps only 
until the alarm signal would have occurred, and the caller’s alarm catch routine is executed just before the 
sleep routine returns, but if the sleep time is less than the time till such alarm, the prior alarm time is reset 
to go off at the same time it would have without the intervening sleep. 

SEE ALSO 

alarm(2), pause(2), signal(2). 



SSIGNALOC) 


SSIGNALOC) 


NAME 

ssignal, gsignal - software signals 

SYNOPSIS 

#mclude <signal.h> 

int (*ssignal (sig, action))() 
int sig, (*action)(); 

int gsignal (sig) 
int sig; 

DESCRIPTION 

Ssignal and gsignal implement a software facility similar to signal(2). This facility is used by the Standard 
C Library to enable the user to indicate the disposition of error conditions, and is also made available to the 
user for his own purposes. 

Software signals made available to users are associated with integers in the inclusive range 1 through 15. 
An action for a software signal is established by a call to ssignal, and a software signal is raised by a call 
to gsignal. Raising a software signal causes the action established for that signal to be taken. 

The first argument to ssignal is a number identifying the type of signal for which an action is to be estab¬ 
lished. The second argument defines the action; it is either the name of a (user defined) action function or 
one of the manifest constants SIG_DFL (default) or SIG_IGN (ignore). Ssignal returns the action previ¬ 
ously established for that signal type; if no action has been established or the signal number is illegal, 
ssignal returns SIG_DFL. 

Gsignal raises the signal identified by its argument, sig : 

If an action function has been established for sig, then that action is reset to SIG_DFL and the action 
function is entered with argument sig. Gsignal returns the value returned to it by the action function. 

If the action for sig is SIG_IGN, gsignal returns the value 1 and takes no other action. 

If the action for sig is SIG_DFL, gsignal returns the value 0 and takes no other action. 

If sig has an illegal value or no action was ever specified for sig, gsignal returns the value 0 and 
takes no other action. 

NOTES 

There are some additional signals with numbers outside the range 1 through 15 which are used by the Stan¬ 
dard C Library to indicate error conditions. Thus, some signal numbers outside the range 1 through 15 are 
legal, although their use may interfere with the operation of the Standard C Library. 
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NAME 

stdio - standard buffered input/output package 

SYNOPSIS 

#mclude <stdio h> 

FILE *stdin, *stdout, *stderr; 

DESCRIPTION 

The functions described in the entries of sub-class 3S of this manual constitute an efficient, user-level I/O 
buffering scheme. The in-line macros gefc(3S) and putc(3S) handle characters quickly. The macros 
getchar, putchar, and the higher-level routines fgetc,/gets, fprintf, fputc^ fputs, fread, fscanf, fwrite, gets, 
getw, print/, puts, putw, and scan/ all use getc and putc; they can be freely intermixed. 

A file with associated buffering is called a stream and is declared to be a pointer to a defined type FILE. 
FopenQS) creates certain descriptive data for a stream and returns a pointer to designate the stream in all 
further transactions. Normally, there are 3 open streams with constant pointers declared in the “include” 
file and associated with the standard open files: 

stdin standard input file 

stdout standard output file 

stderr standard error file. 

A constant “pointer” NULL (0) designates the null stream. 

An integer constant EOF (-1) is returned upon end-of-file or error by most integer functions that deal with 
streams (see the individual descriptions for details). 

Any program that uses this package must include the header file of pertinent macro definitions, as follows: 
#include <stdio.h> 

The functions and constants mentioned in the entries of sub-class 3S of this manual are declared in that 
“include” file and need no further declaration. The constants and the following “functions” are imple¬ 
mented as macros (redeclaration of these names is perilous): getc, getchar, putc, putchar, feof, /error, and 
fileno. 

SEE ALSO 

open(2), close(2), read(2), write(2), ctermid(3S), cuserid(3S), fclose(3S), ferror(3S), fopen(3S), fread(3S), 
fseek(3S), getc(3S), gets(3S), popen(3S), printf(3S), putc(3S), puts(3S), scanf(3S), setbuf(3S), system(3S), 

tmpnam(3S). 

DIAGNOSTICS 

Invalid stream pointers will usually cause grave disorder, possibly including program termination. Individ¬ 
ual function descriptions describe the possible error conditions. 
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NAME 

strcat, strncat, strcmp, strncmp, strcpy, strncpy, strlen, strchr, strrchr, strpbrk, strspn, strcspn, strtok - string 
operations 

SYNOPSIS 

char *strcat (si, s2) 
char *sl, *s2; 

char *strncat (si, s2, n) 
char *sl, *s2; 
int n; 

int strcmp (si, s2) 
char *sl, *s2; 

int strncmp (si, s2, n) 
char *sl, *s2; 
int n; 

char *strcpy (si, s2) 
char *sl, *s2; 

char *strncpy (si, s2, n) 
char *sl, *s2; 
int n; 

int strlen (s) 
char *s; 

char *strchr (s, c) 
char *s, c; 

char *strrchr (s, c) 
char *s, c; 

char *strpbrk (si, s2) 
char *sl, *s2; 

int strspn (si, s2) 
char *sl, *s2; 

int strcspn (si, s2) 
char *sl, *s2; 

char *strtok (si, s2) 
char *sl, *s2; 

DESCRIPTION 

These functions operate on null-terminated strings. They do not check for overflow of any receiving string. 

Strcat appends a copy of string s2 to the end of string s]. Strncat copies at most n characters. Both return 
a pointer to the null-terminated result. 

Strcmp compares its arguments and returns an integer greater than, equal to, or less than 0, according as si 
is lexicographically greater than, equal to, or less than s2. Strncmp makes the same comparison but looks 
at at most n characters. 

Strcpy copies string s2 to si, stopping after the null character has been moved. Strncpy copies exactly n 
characters, truncating or null-padding s2-, the target may not be null-terminated if the length of s2 is n or 
more. Both return i'i. 

Strlen returns the number of non-null characters in s. 

Strchr (strrchr) returns a pointer to the first (last) occurrence of character c in string s, or NULL if c does 
not occur in the string. The null character terminating a string is considered to be part of the string. 
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Strpbrk returns a pointer to the first occurrence in string si of any character from string s2, or NULL if no 
character from s2 exists in si. 

Strspn (strcspn) returns the length of the initial segment of string si which consists entirely of characters 
from (not from) string s2. 

Strtok considers the string si to consist of a sequence of zero or more text tokens separated by spans of one 
or more characters from the separator string s2. The first call (with pointer si specified) returns a pointer to 
the first character of the first token, and will have written a NULL character into si immediately following 
the returned token. Subsequent calls with zero for the first argument, will work through the string si in this 
way until no tokens remain. The separator string s2 may be different from call to call. When no token 
remains in si, a. NULL is returned. 

BUGS 

Strcmp uses native character comparison, which is signed on PDP-1 Is, unsigned on other machines. 

All string movement is performed character by character starting at the left. Thus overlapping moves 
toward the left will work as expected, but overlapping moves to the right may yield surprises. 
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NAME 

swab - swap bytes 
SYNOPSIS 

swab (from, to, nbytes) 
char *from, *to; 
int nbytes; 

DESCRIPTION 

Swab copies nbytes bytes pointed to by from to the position pointed to by to, exchanging adjacent even and 
odd bytes. It is useful for carrying binary data between PDP-lls and other machines. Nbytes should be 
even. 



SYSTEM (3S) 


SYSTEM (3S) 


NAME 

system - issue a shell command 

SYNOPSIS 

#mclude <stdio h> 

int system (string) 
char ^string; 

DESCRIPTION 

System causes the string to be given to sh(l) as input as if the string had been typed as a command at a ter¬ 
minal. The current process waits until the shell has completed, then returns the exit status of the shell. 

SEE ALSO 

sh(l), exec(2). 

DIAGNOSTICS 

System stops if it can’t execute sh(\). 
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NAME 

tmpfile - create a temporary file 

SYNOPSIS 

#mclude <stdio h> 

FILE ^tmpfile () 

DESCRIPTION 

Tmpfile creates a temporary file and returns a corresponding FILE pointer. Arrangements are made so that 
the file will automatically be deleted when the process using it terminates. The file is opened for update. 

SEE ALSO 

creat(2), unlink(2), fopen(3S), mktemp(3C), tmpnam(3S). 
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NAME 

tmpnam - create a name for a temporary file 

SYNOPSIS 

#include <stdio h> 

char *tmpnam (s) 
char *s; 

DESCRIPTION 

Tmpnam generates a file name that can safely be used for a temporary file. If (int).? is zero, tmpnam leaves 
its result in an internal static area and returns a pointer to that area. The next call to tmpnam will destroy 
the contents of the area. If (int)^ is nonzero, s is assumed to be the address of an array of at least 
L_tmpnam bytes; tmpnam places its result in that array and returns s as its value. 

Tmpnam generates a different file name each time it is called. 

Files created using tmpnam and either fopen or creat are only temporary in the sense that they reside in a 
directory intended for temporary use, and their names are unique. It is the user’s responsibility to use 
unlink (2) to remove the file when its use is ended. 

SEE ALSO 

creat(2), unlink(2), fopen(3S), mktemp(3C). 

BUGS 

If called more than 17,576 times in a single process, tmpnam will start recycling previously used names. 
Between the time a file name is created and the file is opened, it is possible for some other process to create 
a file with the same name. This can never happen if that other process is using tmpnam or mktemp, and the 
file names are chosen so as to render duplication by other means unlikely. 
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NAME 

sin, cos, tan, asin, acos, atan, atan2 - trigonometric functions 

SYNOPSIS 

#mclude <math.h> 

double sin (x) 
double x; 

double cos (x) 
double x; 

double asin (x) 
double x; 

double acos (x) 
double x; 

double atan (x) 
double x; 

double atan2 (y, x) 
double X, y; 

DESCRIPTION 

Sin, cos and tan return trigonometric functions of radian arguments. The magnitude of the argument 
should be checked by the caller to make sure the result is meaningful. 

Asin returns the arc sin in the range -nil to nil. 

Acos returns the arc cosine in the range 0 to n. 

Atan returns the arc tangent of x in the range -nil to nil. 

Atan! returns the arc tangent of ylx in the range -n to n. 

DIAGNOSTICS 

Arguments of magnitude greater than 1 cause asin and acos to return value 0. 
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NAME 

ttyname, isatty - find name of a terminal 
SYNOPSIS 

char *ttyname (Aides) 
int isatty (Aides) 

DESCRIPTION 

Ttyname returns a pointer to the null-terminated path name of the terminal device associated with Ale 
descriptor fildes. 

Isatty returns 1 if fildes is associated with a terminal device, 0 otherwise. 

FILES 

/dev/* 

DIAGNOSTICS 

Ttyname returns a null pointer (0) if fildes does not describe a terminal device in directory /dev. 

BUGS 

The return value points to static data whose content is overwritten by each call. 
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NAME 

ungetc - push character back into input stream 

SYNOPSIS 

#mclude <stdio h> 

int ungetc (c, stream) 
char c; 

FILE ^stream; 

DESCRIPTION 

Ungetc pushes the character c back on an input stream. That character will be returned by the next getc 
call on that stream. Ungetc returns c. 

One character of pushback is guaranteed provided something has been read from the stream and the stream 
is actually buffered. Attempts to push EOF are rejected. 

Fseeki'i^) erases all memory of pushed back characters. 

SEE ALSO 

fseek(3S), getc(3S), setbuf(3S). 

DIAGNOSTICS 

Ungetc returns EOF if it can’t push a character back. 
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NAME 

intro - introduction to special files 
DESCRIPTION 

This section describes various special files that refer to specific DEC peripherals and UNIX device drivers. 
The names of the entries are generally derived from DEC names for the hardware, as opposed to the names 
of the special files themselves. Characteristics of both the hardware device and the corresponding UNIX 
device driver are discussed where applicable. 

BUGS 

While the names of the entries generally refer to DEC hardware names, in certain cases these names are 
seemingly arbitrary for various historical reasons. 
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NAME 

cat - phototypesetter interface 
DESCRIPTION 

Cat provides the interface to a Wang Laboratories, Inc. C/A/T phototypesetter. Bytes written on the file 
specify font, size, and other control information as well as the characters to be flashed. The coding will not 
be described here. 

Only one process may have this file open at a time. It is write-only. 

FILES 

/dev/cat 

SEE ALSO 

troff(l). 

Wang Laboratories, Inc. specification (available on request). 
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NAME 

dj - DJ-11 asynchronous multiplexor 
DESCRIPTION 

Each line attached to a DJ-11 communications multiplexer behaves as described in tty {A). Line speeds and 
other characteristics are not programmable but are set by switches in the hardware in groups of 4 lines. 
Only parameters such as character delays and mapping can be altered. 

FILES 

/dev/tty* 

SEE ALSO 

tty(4). 
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NAME 

dmc - communications link with built-in DDCMP protocol 
DESCRIPTION 

The DMCl 1 allows local connection of PDP-11 systems over high-speed (1Mb or 56kb) links and remote 
connection over leased (up to 19.2kb) or dial-up (up to 4,800b) lines. It implements in hardware the 
DDCMP data-link protocol, which includes error control. This driver handles two DMCl 1 devices. 

FILES 

/dev/dmc 

BUGS 

There are quite a few bugs in the DEC microcode for the different versions of the DMC 11. 
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NAME 

dn - DN-11 ACU interface 
DESCRIPTION 

The dn? files are write-only. The permissible codes are: 


0-9 

dial 0-9 

* or: 

dial * 

# or ; 

dial # 

- 

4 second delay for second dial tone 

e or < 

end-of-number 

w or = 

wait for secondary dial tone 

f 

flash off hook for 1 second 


The entire telephone number must be presented in a single write system call. 

FILES 

/dev/dn? 

SEE ALSO 

dh(4), du(4). 
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NAME 

dqs - DQS-11 interface for two-point BSC 
DESCRIPTION 

This interface defines a special file that looks like a concatenation of Binary Synchronous Communication 
(BSC) text blocks. This file may be both written to and read from, but not simultaneously. Data transfer 
with the two-point BSC discipline is strictly half-duplex. 

The device can be opened by only one process at a time. It is expected that a process that successfully 
opens the DQS will spawn separate subprocesses to handle reading and writing. However, no distinction is 
made among the several processes that may have the DQS open. For example, reads within a message, even 
from a single block, may be executed by several processes in sequence. The overriding constraint is that a 
complete message must be read from or written to the DQS before any transfer of data in the opposite direc¬ 
tion can begin. A process that tries to write while the DQS is reading, or vice versa, will be put to sleep 
until the transfer of the currently active message has been completed. 

A complete message consists of one or more text blocks. A message being written to the DQS is terminated 
by a write of zero bytes, which causes an EOT to be transmitted. A message being read from the DQS is ter¬ 
minated by the reception of an EOT (which is not passed on to the reader, but is registered as a read of zero 
bytes). By convention, an EOT follows each block which ends in an ETX. 

The length of a text block cannot exceed 512 bytes, including the line prefix and appendix. These two 
sequences, which must be present in blocks being written and will be passed on in blocks read, are con¬ 
structed from the control bytes SOH, STX, ETB, ETX, DLE. The DQS itself will supply leading SYN bytes 
and trailing block check and pad bytes. The interface examines only the last byte of each text block 
received and so is unaware of the presence of headings or transparent text. The selection and interpretation 
of these features is the user’s responsibility. 

Line control functions, such as the alternating affirmative responses (ACKO) and ACKl), are automatically 
interspersed with text blocks as required by the line discipline. The interface handles the initial line bid and 
the EOT reset at the end of a transmission. A 3-second time-out is also respected. The interface will send 
TTD’s and respond WACK’s if its buffers are not serviced fast enough. When receiving, expiration of the 
time-out will cause the interface to abort the active message by sending EOT. When transmitting, the fail¬ 
ure to send a block successfully after seven tries will cause the interface to terminate the active message 
prematurely. Such aborts cannot be appealed. 

Reads on the DQS will return bytes from a single text block. If one read does not exhaust a text block, suc¬ 
cessive reads will return additional bytes from the same block. A returned count of zero indicates the end 
of a message. Until the remote station bids for the line, all reads will return zero bytes. The error bit will 
never be set by the interface itself, must be read to the end of a message before it will accept writes. 

Writes to the DQS must consist of a single, entire text block. A write that specifies a count of zero bytes 
defines the end of a message. The count returned by a write call must be checked. A count of zero for the 
first write of a new message indicates that it was not possible to acquire the line. Otherwise, the DQS 
should return exactly the count specified in the write call. However, the error bit is set when a line error 
requires that the message be aborted. Notification of the error is not punctual, because data blocks are buf¬ 
fered for transmission. A write of zero bytes must be issued, or an error must occur, before the DQS will 
accept reads. 

An open{2) will fail if the DQS is already open or not ready. The DQS should be opened to allow both read¬ 
ing and writing. 

The DQS interface steals a number of buffers from UNIX (currently two) for the duration of each message. 
This number is specified at system generation time and may be tuned to influence overall system through¬ 
put. 

SEE ALSO 

General Information-Binary Synchronous Communication, IBM Systems Reference Library #GA27-3004. 
DQSll-A/B PDP-11 Communications Controller Option Description, Digital Equipment Corporation. 
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NAME 

du - DU-11 synchronous line interface 
DESCRIPTION 

The files duO, dul, etc., represent interfaces to synchronous modems such as the Bell System 200-series 
synchronous DATA-PHONE nh 

sets. Read and write calls to du? are unlimited, but work best when restricted to less than 512 bytes. Each 
write call is sent as a single record. Seven bits from each byte are written, along with an eighth, odd-parity, 
bit. The “sync” characters must be supplied by the user. Each read call returns the characters read from a 
single record. Seven bits are returned unaltered; the eighth bit is set if the byte was not received in odd par¬ 
ity. An error is returned if data-set ready is not present. 

FILES 

/dev/du? 

SEE ALSO 

dn(4). 
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NAME 

dz, dzk, dh - DZ-11, DZ-11/KMC-l 1, DH-11 asynchronous multiplexers 
DESCRIPTION 

Each line attached to a DH-11 or DZ-11 communications multiplexer behaves as described in tty{A). Input 
and output for each line may independently be set to run at any of 16 speeds; see tty{A) for the encoding. 
(For DZ-11 lines, output speed is always the same as input speed. The 200 speed and the two externally 
clocked speeds {exta, extb) are missing on the DZ-11.) The behavior of dzk lines is indistinguishable from 
that of dz lines, except that on the dzk backspace delays are implemented using fill characters (rubouts) 
instead of timed delays. 

Note that the DH-11 is considered obsolete and is not supported on the VAX-11/780. 

FILES 

/dev/tty* 

SEE ALSO 

kmc(4), tty(4). 
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NAME 

err - error-logging interface 
DESCRIPTION 

Minor device 0 of the err driver is the interface between a process and the system’s error-record collection 
routines. The driver may be opened only for reading by a single process with super-user permissions. Each 
read causes an entire error record to be retrieved; the record is truncated if the read request is for less than 
the record’s length. 

FILES 

/dev/error special file 

SEE ALSO 

errdemon(lM). 
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NAME 

hp - RP04/RP05/RP06 moving-head disk 
DESCRIPTION 

The files rpO,rp7 refer to sections of the RP04/RP05/RP06 disk drive 0. The files rplO,rpl7 refer to 
drive 1, etc. This slicing allows the pack to be broken up into more manageable pieces. 

The origin and size of the sections on each drive are as follows: 

RP04/05 

section start length 

0 0 18392 

1 44 153406 

2 201 87780 

3 358 22154 

4 ^ _ 

5 - - 

6 - - 

7 0 171798 

RP06 

section start length 

0 0 18392 

1 44 322278 

2 201 256652 

3 358 191026 

4 515 125400 

5 672 59774 

6 - - 

7 0 340670 

The start address is a cylinder address, with each cylinder containing 418 blocks. It is extremely unwise for 
all of these files to be present in one installation, since there is overlap in addresses and protection becomes 
a sticky matter. 

The rp files access the disk via the system’s normal buffering mechanism and may be read and written 
without regard to physical disk records. There is also a ‘ ‘raw’ ’ interface which provides for direct transmis¬ 
sion between the disk and the user’s read or write buffer. A single read or write call results in exactly one 
I/O operation and therefore raw I/O is considerably more efficient when many words are transmitted. The 
names of the raw RP files begin with rrp and end with a number which selects the same disk section as the 
corresponding rp file. 

In raw I/O the buffer must begin on a word boundary, and counts should be a multiple of 512 bytes (a disk 
block). Likewise Iseek calls should specify a multiple of 512 bytes. 

FILES 

/dev/rp*, /dev/rrp* 

SEE ALSO 

rp(4). 
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NAME 

hs - RHl 1/RJS03-RJS04 fixed-head disk file 

DESCRIPTION 

The files hsO, hs7 refer to RJS03 disk drives 0 through 7. The files hs8, lislS refer to RJS04 disk 
drives 0 through 7. The RJS03 drives are each 1024 blocks long and the RJS04 drives are 2048 blocks long. 

The hs files access the disk via the system’s normal buffering mechanism and may be read and written 
without regard to physical disk records. There is also a ‘ ‘raw’ ’ interface which provides for direct transmis¬ 
sion between the disk and the user’s read or write buffer. A single read or write call results in exactly one 
I/O operation and therefore raw I/O is considerably more efficient when many words are transmitted. The 
names of the raw HS files begin with rhs. The same minor device considerations hold for the raw interface 
as for the normal interface. 

In raw I/O the buffer must begin on a word boundary, and counts should be a multiple of 512 bytes (a disk 
block). Likewise Iseek calls should specify a multiple of 512 bytes. 

FILES 

/dev/hs*, /dev/rhs* 
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NAME 

ht - TU16 magnetic tape interface 
DESCRIPTION 

The files mtO, mtlS refer to the Digital Equipment Corporation TU16 magnetic tape control and trans¬ 
ports. The files mtO, mt7 are SOObpi, and the files mtS, mtl5 are 1600bpi. The files mtO, mt3, 
mtS, mtll are designated normal-rewind on close, and the files mt4, int7, mtl2, mtlS are no¬ 
rewind on close. When opened for reading or writing, the tape is assumed to be positioned as desired. 
When a file is closed, a double end-of-file (double tape mark) is written if the file was opened for writing. 
If the file was normal-rewind, the tape is rewound. If it is no-rewind and the file was open for writing, the 
tape is positioned before the second EOF just written. If the file was no-rewind and opened read-only, the 
tape is positioned after the EOF following the data just read. Once opened, reading is restricted to between 
the position when opened and the next EOF or the last write. The EOF is returned as a zero-length read. By 
judiciously choosing mt files, it is possible to read and write multi-file tapes. 

A standard tape consists of several 512 byte records terminated by an EOF. To the extent possible, the sys¬ 
tem makes it possible, if inefficient, to treat the tape like any other file. Seeks have their usual meaning and 
it is possible to read or write a byte at a time (although very inadvisable). 

The mt files discussed above are useful when it is desired to access the tape in a way compatible with ordi¬ 
nary files. When foreign tapes are to be dealt with, and especially when long records are to be read or writ¬ 
ten, the “raw” interface is appropriate. The associated files are named rmtO, ..., rmtlS. Each read or 
write call reads or writes the next record on the tape. In the write case the record has the same length as the 
buffer given. During a read, the record size is passed back as the number of bytes read, up to the buffer size 
specified. In raw tape I/O, the buffer must begin on a word boundary and the count must be even. Seeks 
are ignored. An EOF is returned as a zero-length read, with the tape positioned after the EOF, so that the 
next read will return the next record. 


FILES 

/dev/mt*, /dev/rmt* 

BUGS 

If any non-data error is encountered, it refuses to do anything more until closed. The driver is limited to 
four transports. 
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NAME 

kl - KL-11 or DL-11 asynchronous interface 
DESCRIPTION 

The discussion of typewriter I/O given in tty{A) applies to these devices. 

Since they run at a constant speed, attempts to change the speed are ignored. 
The on-line console typewriter is normally interfaced using a KL-11 or DL-11. 

FILES 

/dev/console 

SEE ALSO 

tty(4), init(8). 

BUGS 

Modem control for the DL-1 IE is not implemented. 
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NAME 

kmc - KMC 11 microprocessor 
DESCRIPTION 

The files kmc? are used to manipulate the KMCll-A or -B microprocessors. The device handler provides 
the basic mechanism needed to load, run, and debug programs on the microprocessor. 

The open is exclusive; at most one open at a time. The first open determines whether the microprocessor is 
aKMCll-A or -B. 

Addresses 0-2047 (0-8195) reference the 1024 (4096) words of instructions in the control memory of the 
KMCl 1-A (-B). This portion is word oriented, that is, the address and byte count must be even. 

Addresses 2048-3071 (8196-12211) reference the 1024 (4096) bytes of data in the data memory of the 
KMCl 1-A (-B). The data portion may be read or written with no restrictions on addressing. 

The stty function is used to provide access to the basic microprocessor capabilities. 


stty(kmcfd, arg) 


struct 

{ 



int 

code; 


int 

*csr; 

1 *arg; 

int 

value; 


The pointer csr contains the address of a 4 word buffer for the UNIBUS Control and Status Registers associ¬ 
ated with the microprocessor. The value of code determines the function: 

1 single step and return CSRs in csr. 

2 maintenance step: execute value and then return CSRs. 

3 return CSRs. 

4 stop: clear the run bit. 

5 reset: set then clear the master clear bit. 

6 run: set the run bit and set the software state to value and running. 

7 line unit maintenance: set the line unit bits from value. 

FILES 

/dev/kmc? 

SEE ALSO 

kas(l), kun(l),dh(4). 
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NAME 

Ip - line printer 
DESCRIPTION 

Lp provides the interface to any of the standard Digital Equipment Corporation line printers. When it is 
opened or closed, a suitable number of page ejects is generated. Bytes written are printed. 

An internal parameter within the driver determines whether or not the device is treated as having a 96- or 
64-character set. In half-ASCII mode, lower case letters are turned into upper case and certain characters 
are escaped according to the following table: 

{ 4 

} > 


The driver correctly interprets carriage returns, backspaces, tabs, and form-feeds. A new-line that extends 
over the end of a page is turned into a form-feed. The default line length is 80 characters, indent is 4 char¬ 
acters and lines per page is 66. Lines longer than the line length minus the indent (i.e. 76 characters, using 
the above defaults) are truncated. 

FILES 

/dev/lp 

SEE ALSO 

lpr{l). 
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NAME 

mem, kmem - core memory 
DESCRIPTION 

Mem is a special file that is an image of the core memory of the computer. It may be used, for example, to 
examine, and even to patch the system. 

Byte addresses in mem are interpreted as memory addresses. References to non-existent locations cause 
errors to be returned. 

Examining and patching device registers is likely to lead to unexpected results when read-only or write- 
only bits are present. 

The file kmem is the same as mem except that kernel virtual memory rather than physical memory is 
accessed. 

On the PDP-11, the I/O page begins at location 0160000 of kmem and per-process data for the current pro¬ 
cess begins at 0140000. 

FILES 

/dev/mem, /dev/kmem 

BUGS 

On the PDP-11, memory files are accessed one byte at a time, an inappropriate method for some device reg¬ 
isters. 
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NAME 

null - the null file 
DESCRIPTION 

Data written on a null special file is discarded. 
Reads from a null special file always return 0 bytes. 

FILES 

/dev/null 
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NAME 

pci - parallel communications link interface 
DESCRIPTION 

Pci provides the interface to the Digital Equipment Corporation PCL-llB network bus. This bus can be 
used to interconnect up to 16 CPU’s, providing relatively fast communication without individual point-to- 
point connections. 

The interface permits simultaneous bi-directional communication between any machines on the bus. Addi¬ 
tionally, each such path is further subdivided into 8 independent channels. A control interface is also pro¬ 
vided to reduce the line monitoring overhead for a daemon process. 

FILES 

/dev/pcl[a-z][0-7] normal machine and subchannel interface. 

/dev/pclc control interface. 
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NAME 

prf - operating system profiler 
DESCRIPTION 

The file prf provides access to activity information in the operating system. Writing the file loads the mea¬ 
surement facility with text addresses to be monitored. Reading the file returns these addresses and a set of 
counters indicative of activity between adjacent text addresses. 

The recording mechanism is driven by the system clock and samples the program counter at line frequency. 
Samples that catch the operating system are matched against the stored text addresses and increment corre¬ 
sponding counters for later processing. 

The file prf is a pseudo-device with no associated hardware. 

FILES 

/dev/prf 
SEE ALSO 

config(lM), profiler(lM). 
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NAME 

rf - RFl 1/RS11 fixed-head disk file 

DESCRIPTION 

This file refers to the concatenation of all RS-11 disks. 

Each disk contains 1024 256-word blocks. The length of the combined RF file is 1024x(minor+l) blocks. 
That is minor device zero is taken to be 1024 blocks long; minor device one is 2048, etc. 

The rfO file accesses the disk via the system’s normal buffering mechanism and may be read and written 
without regard to physical disk records. There is also a ‘ ‘raw’ ’ interface which provides for direct transmis¬ 
sion between the disk and the user’s read or write buffer. A single read or write call results in exactly one 
I/O operation and therefore raw I/O is considerably more efficient when many words are transmitted. The 
name of the raw RF file is rrfO. The same minor device considerations hold for the raw interface as for the 
normal interface. 

In raw I/O the buffer must begin on a word boundary, and counts should be a multiple of 512 bytes (a disk 
block). Likewise seek calls should specify a multiple of 512 bytes. 

FILES 

/dev/rfO, /dev/rrfO 

BUGS 

The 512-byte restrictions on the raw device are not physically necessary, but are still imposed. 
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NAME 

rk - RK-11/RK03 or RK05 disk 

DESCRIPTION 

Rk? refers to an entire RK03 disk as a single sequentially-addressed file. Its 256-word blocks are numbered 
Oto 4871. 

The rk files access the disk via the system’s normal buffering mechanism and may be read and written 
without regard to physical disk records. There is also a ‘ ‘raw’ ’ interface which provides for direct transmis¬ 
sion between the disk and the user’s read or write buffer. A single read or write call results in exactly one 
I/O operation and therefore raw I/O is considerably more efficient when many words are transmitted. The 
names of the raw RK files begin with rrk and end with a number which selects the same disk as the corre¬ 
sponding rk file. 

In raw I/O the buffer must begin on a word boundary, and counts should be a multiple of 512 bytes (a disk 
block). Likewise seek calls should specify a multiple of 512 bytes. 

FILES 

/dev/rk*, /dev/rrk* 
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NAME 

rl-RL-ll/RLOl disk 
DESCRIPTION 

rlO,rl3 refer to an entire RLOl disk drive as a single sequentially-addressed file. Its 256-word blocks are 
numbered 0 to 10239. 

The rl files access the disk via the system’s normal buffering mechanism and may be read and written with¬ 
out regard to physical disk records. There is also a “raw” interface which provides for direct transmission 
between the disk and the user’s read or write buffer. A single read or write call results in exactly one I/O 
call and therefore raw I/O is considerably more efficient when many words are transmitted. The names of 
the raw RL files begin with rrl and end with a number which selects the same disk as the corresponding rl 
file. 

In raw I/O the buffer must begin on a word boundary, and counts should be a multiple of 512 bytes (a disk 
block). Likewise Iseek calls should specify a multiple of 512 bytes. 

FILES 

/dev/rl*, /dev/rrl* 
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NAME 

rp - RP-11/RP03 moving-head disk 
DESCRIPTION 

The files rpO,rp7 refer to sections of the RP03 disk drive 0. The files rplO,rpl7 refer to drive 1, etc. 
This slicing allows the pack to be broken up into more manageable pieces. 

The origin and size of the sections on each drive are as follows: 


section 

start 

length 

0 

0 

10000 

1 

50 

71200 

2 

203 

40600 

3 

- 

- 

4 

- 

- 

5 

- 

- 

6 

- 

- 

7 

0 

81200 


The start address is a cylinder address, with each cylinder containing 200 blocks. It is extremely unwise for 
all of these files to be present in one installation, since there is overlap in addresses and protection becomes 
a sticky matter. 

The rp files access the disk via the system’s normal buffering mechanism and may be read and written 
without regard to physical disk records. There is also a ‘ ‘raw’ ’ interface which provides for direct transmis¬ 
sion between the disk and the user’s read or write buffer. A single read or write call results in exactly one 
I/O operation and therefore raw I/O is considerably more efficient when many words are transmitted. The 
names of the raw RP files begin with rrp and end with a number which selects the same disk section as the 
corresponding rp file. 

In raw I/O the buffer must begin on a word boundary, and counts should be a multiple of 512 bytes (a disk 
block). Likewise Iseek calls should specify a multiple of 512 bytes. 

FILES 

/dev/rp*, /dev/rrp* 

SEE ALSO 

hp(4). 
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NAME 

St - synchronous terminal interface 
DESCRIPTION 

The synchronous terminal interface is a pseudo-device driver that enables a UNIX system to communicate 
with a TELETYPE.nh Model 40/4 ASCII synchronous terminal. The driver utilizes the Virtual Protocol 
Machine (VPM) to perform the end-to-end protocol and transmission assurance for the synchronous line. 

The user must be familiar with the operation of the Model 40/4 terminal. Screen management functions are 
completely controlled by the user process; when formating a screen, the user must supply everything from 
the initial STX (Start-of-Text) character to the ETX (End-of-Text) character. 

By convention, /dev/stO is the synchronous terminal control channel, while other /dev/st? files represent 
user terminal channels. Communication with the control channel is handled by the stcntrl command (see 
5r(lM)). 

A user process will sleep when trying to open a channel, until a terminal requests service. At that time, a 
channel will be assigned to that terminal, and it will remain allocated until the user process closes the termi¬ 
nal. 

In addition to the synchronous terminal equipment, a KMCll-B microprocessor, and a DMCll-DA syn¬ 
chronous line unit are required. 

FILES 

/etc/stproto synchronous terminal prototype script 

/dev/kmc? KMCll-B microprocessor 

/dev/vpm? virtual protocol machine 

/dev/stO synchronous terminal control channel 

/dev/st? synchronous terminal user channels 

SEE ALSO 

st(lM), kmc(4), trace(4), vpm(4). 
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NAME 

tm - TMll/TUlO magnetic tape interface 
DESCRIPTION 

The files mtO, mt7 refer to the Digital Equipment Corporation TMll/TUlO magnetic tape control and 
transports at SOObpi. The files mtO, int3 are designated normal-rewind on close, and the files int4, 
mt7 are no-rewind on close. When opened for reading or writing, the tape is assumed to be positioned as 
desired. When a file is closed, a double end-of-file (double tape mark) is written if the file was opened for 
writing. If the file was normal-rewind, the tape is rewound. If it is no-rewind and the file was open for 
writing, the tape is positioned before the second EOF just written. If the file was no-rewind and opened 
read-only, the tape is positioned after the EOF following the data just read. Once opened, reading is 
restricted to between the position when opened and the next EOF or the last write. The EOF is returned as a 
zero-length read. By judiciously choosing mt files, it is possible to read and write multi-file tapes. 

A standard tape consists of several 512 byte records terminated by an EOF. To the extent possible, the sys¬ 
tem makes it possible, if inefficient, to treat the tape like any other file. Seeks have their usual meaning and 
it is possible to read or write a byte at a time (although very inadvisable). 

The mt files discussed above are useful when it is desired to access the tape in a way compatible with ordi¬ 
nary files. When foreign tapes are to be dealt with, and especially when long records are to be read or writ¬ 
ten, the “raw” interface is appropriate. The associated files are named rmtO,..., rmt7 Each read or write 
call reads or writes the next record on the tape. In the write case the record has the same length as the 
buffer given. During a read, the record size is passed back as the number of bytes read, up to the buffer size 
specified. In raw tape I/O, the buffer must begin on a word boundary and the count must be even. Seeks 
are ignored. An EOF is returned as a zero-length read, with the tape positioned after the EOF, so that the 
next read will return the next record. 

FILES 

/dev/mt?, /dev/rmt? 

BUGS 

If any non-data error is encountered, it refuses to do anything more until closed. The driver is limited to 
four transports. 
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NAME 

trace - event-tracing driver 
DESCRIPTION 

Trace is a special file that allows UNIX kernel drivers to transfer event records to a user program, so that the 
activity of the driver may be monitored for debugging purposes. 

An event record is generated from within a kernel driver by executing the following function: 

trsave(dev, chno, buf, cnt) 
char dev, chno, *buf, cnt; 

Dev is the minor device number of the trace driver; chno is an integer between 1 and 16, inclusive, identi¬ 
fying the data stream to which the record belongs; buf is a buffer containing the bytes that make up a single 
event record; and cnt is the number of bytes in buf. Calls to trsave will result in data being saved in a clist 
buffer, provided that some user program has opened the trace minor device number dev and has activated 
channel chno. Event records prefaced by chno and cnt are stored in a clist queue until a system-defined 
maximum (TRQMAX) is reached; event records are discarded while the queue is full. The clist queue is 
emptied by a user program reading the trace driver. The trace driver returns an integral number of event 
records; the read count must, therefore, be at least equal to the size of a record plus two, to allow for the 
chno and cnt bytes added to the event record by the trsave routine. 

The trace driver supports open, close, read, and ioctl system calls. To activate a channel, ioctl is used as 
follows: 

#include <ioctl h> 
ioctl(fildes, VPMTRCO, chno) 

SEE ALSO 

vpmstart(lC), vpm(4). 
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NAME 

tty - general terminal interface 
DESCRIPTION 

This section describes both a particular special file and the general nature of the terminal interface. 

The file /dev/tty is, in each process, a synonym for the control terminal associated with the process group 
of that process, if any. It is useful for programs or shell sequences that wish to be sure of writing messages 
on the terminal no matter how output has been redirected. It can also be used for programs that demand the 
name of a file for output, when typed output is desired and it is tiresome to find out what terminal is cur¬ 
rently in use. 

As for terminals in general: all of the asynchronous communications ports use the same general interface, 
no matter what hardware is involved. The remainder of this section discusses the common features of this 
interface. 

When a terminal file is opened, it normally causes the process to wait until a connection is established. In 
practice, users’ programs seldom open these files; they are opened by getty{%) and become a user’s standard 
input, output, and error files. The very first terminal file opened by the process group leader of a terminal 
file not already associated with a process group becomes the control terminal for that process group. The 
control terminal plays a special role in handling quit and interrupt signals, as discussed below. The control 
terminal is inherited by a child process during afork(2). A process can break this association by changing 
its process group using setpgrp{2). 

A terminal associated with one of these files ordinarily operates in full-duplex mode. Characters may be 
typed at any time, even while output is occurring, and are only lost when the system’s character input 
buffers become completely full, which is rare, or when the user has accumulated the maximum allowed 
number of input characters that have not yet been read by some program. Currently, this limit is 256 char¬ 
acters. When the input limit is reached, all the saved characters are thrown away without notice. 

Normally, terminal input is processed in units of lines. A line is delimited by a new-line (ASCII LF) charac¬ 
ter, an end-of-file (ASCII EOT) character, or an end-of-line character. This means that a program attempting 
to read will be suspended until an entire line has been typed. Also, no matter how many characters are 
requested in the read call, at most one line will be returned. It is not, however, necessary to read a whole 
line at once; any number of characters may be requested in a read, even one, without losing information. 

During input, erase and kill processing is normally done. By default, the character # erases the last charac¬ 
ter typed, except that it will not erase beyond the beginning of the line. By default, the character @ kills 
(deletes) the entire input line, and optionally outputs a new-line character. Both these characters operate on 
a key-stroke basis, independently of any backspacing or tabbing that may have been done. Both the erase 
and kill characters may be entered literally by preceding them with the escape character (\). In this case the 
escape character is not read. The erase and kill characters may be changed. 

Certain characters have special functions on input. These functions and their default character values are 
summarized as follows: 

INTR (Rubout or ASCII DEL) generates an interrupt signal which is sent to all processes with the asso¬ 
ciated control terminal. Normally, each such process is forced to terminate, but arrangements 
may be made either to ignore the signal or to receive a trap to an agreed-upon location; see 
signal {2). 

QUIT (Control-1 or ASCII FS) generates a quit signal. Its treatment is identical to the interrupt signal 
except that, unless a receiving process has made other arrangements, it will not only be termi¬ 
nated but a core image file (called core) will be created in the current working directory. 

ERASE (#) erases the preceding character. It will not erase beyond the start of a line, as delimited by a 
NL, EOF, or EOL character. 

KILL (@) deletes the entire line, as delimited by a NL, EOF, or EOL character. 
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EOF (Control-d or ASCII EOT) may be used to generate an end-of-file from a terminal. When received, 
all the characters waiting to be read are immediately passed to the program, without waiting for a 
new-line, and the EOF is discarded. Thus, if there are no characters waiting, which is to say the 
EOF occurred at the beginning of a line, zero characters will be passed back, which is the standard 
end-of-file indication. 

NL (ASCII LF) is the normal line delimiter. It can not be changed or escaped. 

EOL (ASCII NUL) is an additional line delimiter, like NL. It is not normally used. 

STOP (Control-s or ASCII DC3) can be used to temporarily suspend output. It is useful with CRT termi¬ 
nals to prevent output from disappearing before it can be read. While output is suspended, STOP 
characters are ignored and not read. 

START (Control-q or ASCII DCl) is used to resume output which has been suspended by a STOP charac¬ 
ter. While output is not suspended, START characters are ignored and not read. The start/stop 
characters can not be changed or escaped. 

The character values for INTR, QUIT, ERASE, KILL, EOF, and EOL may be changed to suit individual tastes. 
The ERASE, KILL, and EOF characters may be escaped by a preceding \ character, in which case no special 
function is done. 

When the carrier signal from the data-set drops, a hangup signal is sent to all processes that have this termi¬ 
nal as the control terminal. Unless other arrangements have been made, this signal causes the processes to 
terminate. If the hangup signal is ignored, any subsequent read returns with an end-of-file indication. Thus 
programs that read a terminal and test for end-of-file can terminate appropriately when hung up on. 

When one or more characters are written, they are transmitted to the terminal as soon as previously-written 
characters have finished typing. Input characters are echoed by putting them in the output queue as they 
arrive. If a process produces characters more rapidly than they can be typed, it will be suspended when its 
output queue exceeds some limit. When the queue has drained down to some threshold, the program is 
resumed. 

Several ioctl(2) system calls apply to terminal files. The primary calls use the following structure, defined 

in <termio.h>: 

#define NCC 8 

struct termio { 


unsigned 

short 

c iflag; 

/* input modes */ 

unsigned 

short 

c oflag; 

/* output modes */ 

unsigned 

short 

c cflag; 

/* control modes */ 

unsigned 

short 

c Iflag; 

/* local modes */ 

char 


c line; 

/* line discipline */ 

unsigned 

char 

c_cc[NCC]; 

/* control chars */ 


}; 

The special control characters are defined by the array c_cc. The relative positions and initial values for 
each function are as follows: 

0 INTR DEL 

1 QUIT FS 

2 ERASE # 

3 KILL @ 

4 EOF EOT 

5 EOL NUL 

6 reserved 

7 reserved 

The cjflag field describes the basic terminal input control: 

IGNBRK 0000001 Ignore break condition. 

BRKINT 0000002 Signal interrupt on break. 
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IGNPAR 

0000004 

PARMRK 

0000010 

INPCK 

0000020 

ISTRIP 

0000040 

INLCR 

0000100 

IGNCR 

0000200 

ICRNL 

0000400 

lUCLC 

0001000 

IXON 

0002000 

IXANY 

0004000 

IXOFF 

0010000 


Ignore characters with parity errors. 
Mark parity errors. 

Enable input parity check. 

Strip character. 

Map NL to CR on input. 

Ignore CR. 

Map CR to NL on input. 

Map upper-case to lower-case on input. 
Enable start/stop output control. 

Enable any character to restart output. 
Enable start/stop input control. 


If IGNBRK is set, the break condition (a character framing error with data all zeros) is ignored, that is, not 
put on the input queue and therefore not read by any process. Otherwise if BRKINT is set, the break condi¬ 
tion will generate an interrupt signal and flush both the input and output queues. If IGNPAR is set, charac¬ 
ters with other framing and parity errors are ignored. 


If PARMRK is set, a character with a framing or parity error which is not ignored is read as the three charac¬ 
ter sequence: 0377, 0, X, where X is the data of the character received in error. To avoid ambiguity in this 
case, if ISTRIP is not set, a valid character of 0377 is read as 0377, 0377. If PARMRK is not set, a framing 
or parity error which is not ignored is read as the character NUL (0). 

If INPCK is set, input parity checking is enabled. If INPCK is not set, input parity checking is disabled. 
This allows output parity generation without input parity errors. 


If ISTRIP is set, valid input characters are first stripped to 7-bits, otherwise all 8-bits are processed. 

If INLCR is set, a received NL character is translated into a CR character. If IGNCR is set, a received CR 
character is ignored (not read). Otherwise if ICRNL is set, a received CR character is translated into a NL 
character. 


If lUCLC is set, a received upper-case alphabetic character is translated into the corresponding lower-case 
character. 


If IXON is set, start/stop output control is enabled. A received STOP character will suspend output and a 
received START character will restart output. All start/stop characters are ignored and not read. If IXANY 
is set, any input character, will restart output which has been suspended. 

If IXOFF is set, the system will transmit START/STOP characters when the input queue is nearly empty/full. 
The initial input control value is all bits clear. 

The c_oflag field specifies the system treatment of output: 


OPOST 

0000001 

Postprocess output. 

OLCUC 

0000002 

Map lower case to upper on output. 

ONLCR 

0000004 

Map NL to CR-NL on output. 

OCRNL 

0000010 

Map CR to NL on output. 

ONOCR 

0000020 

No CR output at column 0. 

ONLRET 

0000040 

NL performs CR function. 

OFILL 

0000100 

Use fill characters for delay. 

OFDEL 

0000200 

Fill is DEL, else NUL. 

NLDLY 

0000400 

Select new-line delays: 

NLO 

0 


NLl 

0000400 


CRDLY 

0003000 

Select carriage-return delays: 

CRO 

0 


CRl 

0001000 


CR2 

0002000 


CR3 

0003000 
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TABDLY 0014000 Select horizontal-tab delays: 

TABO 0 

TABl 0004000 

TAB2 0010000 

TAB3 0014000 Expand tabs to spaces. 

BSDLY 0020000 Select backspace delays: 

BSO 0 

BSl 0020000 

VTDLY 0040000 Select vertical-tab delays: 

VTO 0 

VTl 0040000 

FFDLY 0100000 Select form-feed delays: 

FFO 0 

FFl 0100000 

If OPOST is set, output characters are post-processed as indicated by the remaining flags, otherwise charac¬ 
ters are transmitted without change. 

If OLCUC is set, a lower-case alphabetic character is transmitted as the corresponding upper-case character. 
This function is often used in conjunction with lUCLC. 

If ONLCR is set, the NL character is transmitted as the CR-NL character pair. If OCRNL is set, the CR char¬ 
acter is transmitted as the NL character. If ONOCR is set, no CR character is transmitted when at column 0 
(first position). If ONLRET is set, the NL character is assumed to do the carriage-return function; the col¬ 
umn pointer will be set to 0 and the delays specified for CR will be used. Otherwise the NL character is 
assumed to do just the line-feed function; the column pointer will remain unchanged. The column pointer 
is also set to 0 if the CR character is actually transmitted. 

The delay bits specify how long transmission stops to allow for mechanical or other movement when cer¬ 
tain characters are sent to the terminal. In all cases a value of 0 indicates no delay. If OFILL is set, fill char¬ 
acters will be transmitted for delay instead of a timed delay. This is useful for high baud rate terminals 
which need only a minimal delay. If OFDF.T. is set, the fill character is DEL, otherwise NUL. 

If a form-feed or vertical-tab delay is specified, it lasts for about 2 seconds. 

New-line delay lasts about 0.10 seconds. If ONLRET is set, the carriage-return delays are used instead of 
the new-line delays. If OFILL is set, two fill characters will be transmitted. 

Carriage-return delay type 1 is dependent on the current column position, type 2 is about 0.10 seconds, and 
type 3 is about 0.15 seconds. If OFILL is set, delay type 1 transmits two fill characters, and type 2 four fill 
characters. 

Horizontal-tab delay type 1 is dependent on the current column position. Type 2 is about 0.10 seconds. 
Type 3 specifies that tabs are to be expanded into spaces. If OFILL is set, two fill characters will be trans¬ 
mitted for any delay. 

Backspace delay lasts about 0.05 seconds. If OFILL is set, one fill character will be transmitted. 

The actual delays depend on line speed and system load. 

The initial output control value is all bits clear. 

The cjcflag field describes the hardware control of the terminal: 


CBAUD 

0000017 

Baud rate: 

BO 

0 

Hang up 

B50 

0000001 

50 baud 

B75 

0000002 

75 baud 

BllO 

0000003 

no baud 

B134 

0000004 

134.5 baud 

B150 

0000005 

150 baud 
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B200 

0000006 

200 baud 

B300 

0000007 

300 baud 

B600 

0000010 

600 baud 

B1200 

0000011 

1200 baud 

B1800 

0000012 

1800 baud 

B2400 

0000013 

2400 baud 

B4800 

0000014 

4800 baud 

B9600 

0000015 

9600 baud 

EXTA 

0000016 

External A 

EXTB 

0000017 

External B 

CSIZE 

0000060 

Character size: 

CS5 

0 

5 bits 

CS6 

0000020 

6 bits 

CS7 

0000040 

7 bits 

CS8 

0000060 

8 bits 

CSTOPB 

0000100 

Send two stop bits, else one. 

CREAD 

0000200 

Enable receiver. 

PARENB 

0000400 

Parity enable. 

PARODD 

0001000 

Odd parity, else even. 

HUPCL 

0002000 

Hang up on last close. 

CLOCAL 

0004000 

Local line, else dial-up. 


The CBAUD bits specify the baud rate. The zero baud rate, BO, is used to hang up the connection. If BO is 
specified, the data-terminal-ready signal will not be asserted. Normally, this will disconnect the line. For 
any particular hardware, impossible speed changes are ignored. 

The CSIZE bits specify the character size in bits for both transmission and reception. This size does not 
include the parity bit, if any. If CSTOPB is set, two stop bits are used, otherwise one stop bit. For example, 
at 110 baud, two stops bits are required. 

If PARENB is set, parity generation and detection is enabled and a parity bit is added to each character. If 
parity is enabled, the PARODD flag specifies odd parity if set, otherwise even parity is used. 

If CREAD is set, the receiver is enabled. Otherwise no characters will be received. 

If HUPCL is set, the line will be disconnected when the last process with the line open closes it or termi¬ 
nates. That is, the data-terminal-ready signal will not be asserted. 

If CLOCAL is set, the line is assumed to be a local, direct connection with no modem control. Otherwise 
modem control is assumed. 


The initial hardware control value after open is B300, CSS, CREAD, HUPCL. 

The cjflag field of the argument structure is used by the line discipline to control terminal functions. The 
basic line discipline (0) provides the following: 


ISIG 

0000001 

ICANON 

0000002 

XCASE 

0000004 

ECHO 

0000010 

ECHOE 

0000020 

ECHOK 

0000040 

ECHONL 

0000100 

NOFLSH 

0000200 


Enable signals. 

Canonical input (erase and kill processing). 
Canonical upper/lower presentation. 

Enable echo. 

Echo erase character as BS-SP-BS. 

Echo NL after kill character. 

Echo NL. 

Disable flush after interrupt or quit. 


If ISIG is set, each input character is checked against the special control characters INTR and QUIT. If an 
input character matches one of these control characters, the function associated with that character is per¬ 
formed. If ISIG is not set, no checking is done. Thus these special input functions are possible only if ISIG 
is set. These functions may be disabled individually by changing the value of the control character to an 
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unlikely or impossible value (e.g. 0377). 

If ICANON is set, canonical processing is enabled. This enables the erase and kill edit functions, and the 
assembly of input characters into lines delimited by NL, EOF, and EOL. If ICANON is not set, read requests 
are satisfied directly from the input queue. A read will not be satisfied until at least MIN characters have 
been received or the timeout value TIME has expired. This allows fast bursts of input to be read efficiently 
while still allowing single character input. The MIN and TIME values are stored in the position for the EOF 
and EOL characters respectively. The time value represents tenths of seconds. 

If XCASE is set, and if ICANON is set, an upper-case letter is accepted on input by preceding it with a \ 
character, and is output preceded by a \ character. In this mode, the following escape sequences are gener¬ 
ated on output and accepted on input: 

for: use: 

" V 

I \! 

\" 

{ \( 

} \) 

\ W 

For example, A is input as \a, \n as \\n, and \N as \\\n. 

If ECHO is set, characters are echoed as received. 

When ICANON is set, the following echo functions are possible. If ECHO and ECHOE are set, the erase 
character is echoed as ASCII BS SP BS, which will clear the last character from a CRT screen. If ECHOE is 
set and ECHO is not set, the erase character is echoed as ASCII SP BS. If ECHOK is set, the NL character 
will be echoed after the kill character to emphasize that the line will be deleted. Note that an escape charac¬ 
ter preceding the erase or kill character removes any special function. If ECHONL is set, the NL character 
will be echoed even if ECHO is not set. This is useful for terminals set to local echo (so-called half duplex). 
Unless escaped, the EOF character is not echoed. Because EOT is the default EOF character, this prevents 
terminals that respond to EOT from hanging up. 

If NOFLSH is set, the normal flush of the input and output queues associated with the quit and interrupt 
characters will not be done. 

The initial line-discipline control value is all bits clear. 

The primary ioctl(2) system calls have the form: 

ioctl (hides, command, arg) 
struct termio *arg; 

The commands using this form are: 

TCGETA Get the parameters associated with the terminal and store in the termio structure ref¬ 
erenced by arg. 

TCSETA Set the parameters associated with the terminal from the structure referenced by arg. 
The change is immediate. 

TCSETAW Wait for the output to drain before setting the new parameters. This form should be 
used when changing parameters that will affect output. 

TCSETAF Wait for the output to drain, then flush the input queue and set the new parameters. 
Additional ioctl(2) calls have the form: 

ioctl (hides, command, arg) 
int arg; 

The commands using this form are: 
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TCSBRK Wait for the output to drain. If arg is 0, then send a break (zero bits for 0.25 sec¬ 
onds). 

TCXONC Start/stop control. If arg is 0, suspend output; if 1, restart suspended output. 

TCFLSH If arg is 0, flush the input queue; if 1, flush the output queue; if 2, flush both the 

input and output queues. 

FILES 

/dev/tty 

/dev/tty* 

/dev/console 

SEE ALSO 

stty(l), ioctl(2). 
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NAME 

vp - Versatec printer 
DESCRIPTION 

Vp provides the interface to the Versatec electro-static line printer. Both printing and plotting capabilities 
are implemented. 

FILES 

/dev/vp 

SEE ALSO 

vpr(l), lp(4). 
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NAME 

vpm - The Virtual Protocol Machine 
DESCRIPTION 

This entry describes a particular kind of special file and gives an introduction to the Virtual Protocol 
Machine (VPM). 

The VPM is a software construct for implementing link protocols on the KMCl 1 in a high-level language. 
This is accomplished by a compiler that runs on UNIX and that translates a high-level language description 
of a protocol into an intermediate language that is interpreted by an interpreter running in the KMCl 1. 

The VPM driver is functionally split into two parts: a top VPM device and a bottom VPM device. The top 
device may be modified or replaced to suit particular applications; the bottom device interfaces with the 
VPM interpreter using the KMC driver. When using the mknod command to make a directory entry and cor¬ 
responding i-node for a VPM special file, the minor device number identifies the top, bottom, and physical 
KMC devices to be used for this special file. The two most significant bits of the minor device number 
denote the physical KMC device; the next two bits denote the VPM bottom device; the four least significant 
bits denote the VPM top device. For example, if top device 1 is to be used with bottom device 2, which in 
turn is to be used with KMC device 3, the minor device number would be 0341(octal). 

UNIX user processes transfer data to or from a remote terminal or computer system through VPM using nor¬ 
mal open, read, write, and close operations. Flow control and error recovery are provided by the protocol 
description residing in the KMCl 1. 

The VPM software consists of six components: 

1. vpwc(lC): compiler for the protocol description language; it runs on UNIX. 

2. VPM interpreter: a KMCl 1 program that controls the overall operation of the KMCl 1 and 
interprets the protocol script. 

3. vpm.c: a UNIX driver that provides the interface to the VPM. 

4. vpmstart(lC): a UNIX command that copies a load module into the KMCl 1 and starts it. 

5. vpmsnap(lC): a UNIX command that prints a time-stamped event trace while the protocol 
is running. 

6. vpmtrace{lC): a UNIX command that prints an event trace for debugging purposes while 
the protocol is running. 

The VPM open for reading-and-writing is exclusive; opens for reading-only or writing-only are not. The 
VPM open checks that the correct interpreter is running in the KMC 11, then sends a RUN command to the 
interpreter (causing it to start interpreting the protocol script), and supplies a 512-byte receive buffer to the 
interpreter. 

The VPM read returns either the number of bytes requested or the number remaining in the current receive 
buffer, whichever is less. Bytes remaining in a receive buffer are used to satisfy subsequent reads. The 
VPM write copies the user data into 512-byte system buffers and passes them to the VPM interpreter in the 
KMCl 1 for transmission. 

The VPM close arranges for the return of system buffers and for a general cleanup when the last transmit 
buffer has been returned by the interpreter. 

The user command vpmtrace{\C) reads the trace driver and prints event records. While this command is 
executing, the VPM driver will generate a number of event records, allowing the activity of the VPM driver 
and protocol script to be monitored for debugging purposes. The system functions vpmopen, vpmread, 
vpmwrite, and vpmclose generate event records (identified respectively by o, r, w, and c). Calls to the 
vpmc{lC) primitive trace(argl ,arg2) cause the VPM interpreter to pass argl and arg2 along with the cur¬ 
rent value of the script location counter to the VPM driver, which generates an event record identified by a 
T. Each event record is structured as follows: 

struct event { 

short e_seqn; /*sequence number*/ 

char e_type; /*record identifier*/ 
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char 

e dev; 

/*minor device number*/ 

short 

e short 1; 

/*data*/ 

short 

e short2; 

/*data*/ 


} 

When the script terminates for any reason, the driver is notified and generates an event record identified by 
an E. This record also contains the minor device number, the script location counter, and a termination 
code defined as follows; 

0 Normal termination; the interpreter received a halt command from the driver. 

1 Undefined virtual-machine operation code. 

2 Script program counter out of bounds. 

3 Interpreter stack overflow or underflow. 

4 Jump address not even. 

5 UNIBUS error. 

6 Transmit buffer has an odd address; the driver tried to give the interpreter too many trans¬ 
mit buffers; or a get or rtnxbuf was executed while no transmit buffer was open, i.e., no 
getxbuf was executed prior to the get or rtnxbuf. 

1 Receive buffer has an odd address; the driver tried to give the interpreter too many 
receive buffers; or a put or rtnrbuf was executed while no receive buffer was open, i.e., 
no getrbuf was executed prior to the get or rtnxbuf. 

8 The script executed an exit. 

9 A crcl6 was executed without a preceding crcloc execution. 

10 Interpreter detected loss of modem-ready signal. 

11 Transmit-buffer sequence-number error. 

12 Command error; an invalid command or an improper sequence of commands was 
received from the driver. 

13 Not used. 

14 Invalid transmit state. 

15 Invalid receive state. 

16 Not used. 

17 Xmtctl or setctl attempted while transmitter was still busy. 

18 Not used. 

19 Same as error code 6. 

20 Same as error code 7. 

21 Script to large. 

22 Used for debugging the interpreter. 

23 The driver’s OK-check has timed out. 

SEE ALSO 

vpmc(lC), vpmstart(lC), trace(4). 
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NAME 

intro - introduction to file formats 
DESCRIPTION 

This section outlines the formats of various files. The C struct declarations for the file formats are given 
where applicable. Usually, these structures can be found in the directories /usr/include or 
/usr/include/sys. 
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NAME 

a.out - assembler and link editor output 
DESCRIPTION 

A.out is the output file of the assembler as and the link editor Id. Both programs will make a.out exe¬ 
cutable if there were no errors in assembling or linking, and no unresolved external references. 

This file has four sections: a header, the program text and data segments, relocation information, and a sym¬ 
bol table (in that order). The last two sections may be missing if the program was linked with the -s option 
of /J(l) or if the symbol table and relocation bits were removed by strip(\). Also note that if there were no 
unresolved external references after linking, the relocation information will be removed. 

The sizes of each segment (contained in the header, discussed below) are in bytes and are even. The size of 
the header is not included in any of the other sizes. 

When an a.out file is loaded into memory for execution, three logical segments are set up: the text segment, 
the data segment (initialized data followed by uninitialized, the latter actually being initialized to all O’s), 
and a stack. The text segment begins at location 0 in the core image; the header is not loaded. If the magic 
number (the first field in the header) is 407 (octal), it indicates that the text segment is not to be write- 
protected or shared, so the data segment will be contiguous with the text segment. If the magic number is 
410 (octal), the data segment begins at the first 0 mod 8K byte boundary on the PDP-11, or the first 0 mod 
512 byte boundary on the VAX-11/7 80 following the text segment, and the text segment is not writable by 
the program; if other processes are executing the same a.out file, they will share a single text segment. If 
the magic number is 411 (octal) (PDP-11 only), the text segment is again pure (write-protected and shared) 
and, moreover, the instruction and data spaces are separated; the text and data segment both begin at loca¬ 
tion 0. See the PDP-11/70 Processor Handbook for restrictions that apply to this situation. 

The stack will occupy the highest possible locations in the core image: from 177776 (octal) on the PDP-11 
or 80000000 (hexidecimal) on the VAX-11/780, and growing downwards. The stack is automatically 
extended as required. The data segment is only extended as requested by the brkil) system call. 

The start of the text segment in the a.out file is hsize \ the start of the data segment is hsize-¥S^ (the size of 
the text), where hsize is 20 (octal) on the PDP-11 and 20 (hexidecimal) on the VAX-11/780. 

The value of a word in the text or data portions that is not a reference to an undefined external symbol is 
exactly the value that will appear in memory when the file is executed. If a word in the text or data portion 
involves a reference to an undefined external symbol, as indicated by the relocation information (discussed 
below) for that word, then the value of the word as stored in the file is an offset from the associated external 
symbol. When the file is processed by the link editor and the external symbol becomes defined, the value 
of the symbol will be added to the word in the file. 

Header-PDP-11 

The format of the a.out header for the PDP-11 is as follows: 
struct exec { 


short 

a magic; 

/* magic number */ 

unsigned 

a text; 

/* size of text segment */ 

unsigned 

a data; 

/* size of data segment */ 

unsigned 

a bss; 

/* size of bss segment */ 

unsigned 

a syms; 

/* size of symbol table */ 

unsigned 

a entry; 

/* entry point of program */ 

unsigned 

a stamp; 

/* version stamp */ 

unsigned 

a flag; 

/* set if relocation info stripped */ 
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Header-VAX.11/780 

The format of the header on the VAX-11/780 is as follows: 

struct exec { 

short a_magic; /* magic number */ 

short a_stamp; /* version stamp */ 

unsigned a_text; /* size of text segment */ 

unsigned a_data; /* size of data segment */ 

unsigned a_bss; /* size of bss segment */ 

unsigned a_syms; /* size of symbol table */ 
unsigned a_entry; /* entry point of program */ 
unsigned a_trsize; /* size of text relocation info */ 

unsigned a_drsize; /* size of data relocation info */ 

}; 

Relocation-PDP-ll 

If relocation information is present, it amounts to two bytes per relocatable datum. There is no relocation 
information if the “suppress relocation” flag (ajiag) in the header is on. 

The format of the relocation data is: 

struct r_info { 

int r_symbolnum: 11, 
r_segment:3, 
r_pcrel:l; 

}; 

The r jjcrel field indicates, if on , that the reference is relative to the program counter (pc) register (e.g., clr 
x); if off, that the reference is to the actual symbol (e.g., clr *$x). 

The rjsegment field indicates the segment referred to by the text or data word associated with the relocation 
word: 

00 indicates the reference is absolute; 

02 indicates the reference is to the text segment; 

04 indicates the reference is to initialized data; 

06 indicates the reference is to bss (uninitialized data); 

10 indicates the reference is to an undefined external symbol. 

The field r_symbolnum contains a symbol number in the case of external references, and is unused other¬ 
wise. The first symbol is numbered 0, the second 1, etc. 

Relocation-VAX-11/780 

If relocation information is present, it amounts to eight bytes per relocatable datum. There are no relocation 
bits if a_trsize-¥a_drsize~Q. The format of the relocation information is: 

struct r_info { 

long r_address; 

int r_symbolnum:24, 

r_pcrel:l, 
r_length:2, 
r_extem:l, 
roffset:!, 
r_pad:3; 

}; 

The r_address field gives the location of the relocatable reference relative to the segment in which it is 
defined. The r_symholnum field contains a symbol number in the case of an external; otherwise it contains 
a segment number (expressed in the same manner as the VAX-11/780 symbol types above). RJ)crel has 
the same meaning as on the PDP-11. RJength indicates the length of the relocatable reference: 
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0 byte 

1 word 

2 long 

The start of the relocation information (on the PDP-11 and the VAX-11/780) is: 
hsize +a_text +a_data 

Symbol Table-PDP-11 

The symbol table on the PDP-11 consists of entries of the form: 

struct nlist { 

char n_name[8]; 

int n_type; 

unsigned n_value; 

}; 

The njiame field contains the ASCII name of the symbol, null-padded. The njype field indicates the type 
of the symbol; the following values are possible: 

00 undefined symbol 

01 absolute symbol 

02 text segment symbol 

03 data segment symbol 

04 bss segment symbol 

37 file name symbol (produced by Id) 

40 undefined external symbol 

41 absolute external symbol 

42 text segment external symbol 

43 data segment external symbol 

44 bss segment external symbol 

The start of the symbol table on the PDP-11 is: 

hsize+2{a_text +a_data ) 
if relocation information is present, and 

hsize +a_text +a_data 
if it is not. 

Symbol Table-VAX-11/780 

The symbol table on the VAX consists of entries of the form: 

struct nlist { 

char n_name[8]; 

char n_type; 

char n_other; 

short n_desc; 

unsigned n_value; 

}; 

The possible values for njype are: 
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00 undefined symbol 

02 absolute symbol 

04 text segment symbol 

06 data segment symbol 

08 bss segment symbol 

37 file name symbol (produced by ld(\)) 

40 undefined external symbol 
42 absolute external symbol 
44 text segment external symbol 

46 data segment external symbol 

48 bss segment external symbol 

The start of the symbol table on the VAX is: 

hsize +a_text +a_data +a_trsize +a_drsize 

If a symbol’s type (on either the PDP-11 or the VAX-11/780) is undefined external and the value field is 
non-zero, the symbol is interpreted by the link editor ld{\) as the name of a common region whose size is 
indicated by the value of the symbol. 

SEE ALSO 

as(l), ld(l), nm(l), strip(l). 
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NAME 

acct - per-process accounting file format 
SYNOPSIS 

#mclude <sys/acct h> 

DESCRIPTION 

Files produced as a result of calling acc((2) have records in the form defined by <sys/acct h>, whose con¬ 
tents are: 

h 

* Accounting structures 
*1 


typedef ushort comp_t; /* "floating point" */ 

/* 13-bit fraction, 3-bit exponent */ 


struct acct 

r 



1 

char 

ac flag; 

/* Accounting flag */ 

char 

ac stat; 

/* Exit status */ 

ushort 

ac uid; 

/* Accounting user ID */ 

ushort 

ac gid; 

/* Accounting group ID */ 

dev t 

ac tty; 

/* control typewriter */ 

time t 

ac btime; 

/* Beginning time */ 

comp t 

ac utime; 

/* acctng user time in clock ticks */ 

comp t 

ac stime; 

/* acctng system time in clock ticks */ 

comp t 

ac etime; 

/* acctng elapsed time in clock ticks */ 

comp t 

ac mem; 

/* memory usage */ 

comp t 

ac io; 

/* chars transferred */ 

comp t 

ac rw; 

/* blocks read or written */ 

char 

}; 

ac comm[8]; 

/* command name */ 

extern struct 

acct 

acctbuf; 

extern struct 

inode 

*acctp; /* inode of accounting file */ 

#define AFORK 01 

/* has executed fork, but no exec */ 

#define ASU 

02 

/* used super-user privileges */ 

#define ACCTF 

0300 

/* record type: 00 = acct */ 


In acjiag, the AFORK flag is turned on by each fork(2) and turned off by an exec(2). The ac_comm field 
is inherited from the parent process and is reset by any exec. Each time the system charges the process with 
a clock tick, it also adds to acjnem the current process size, computed as follows: 

(data size) + (text size) / (number of in-core processes using text) 

The value of ac_mem/ac_stime can be viewed as an approximation to the mean process size, as modified 
by text-sharing. 
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The following structure represents the total accounting format used by the various accounting commands: 

/* 

* total accounting (for acct period), also for day 
*1 


struct tacct { 

uid t 

ta uid; 

/* 

char 

ta name[8]; /* 

float 

ta cpu[2]; 

/* 

float 

ta kcore[2]; /* 

float 

ta con[2]; 

/* 

float 

ta du; 

/* 

long 

ta_pc; 

/* 

unsigned short 

ta sc; 

/* 

unsigned short 

ta dc; 

/* 

unsigned short 

ta fee; 

/* 


}; 


userid */ 
login name */ 

cum. cpu time, p/np (mins) */ 
cum kcore-minutes, p/np */ 
cum. connect time, p/np, mins */ 
cum. disk usage */ 
count of processes */ 
count of login sessions */ 
count of disk samples */ 
fee for special services */ 


SEE ALSO 

acct(lM), acctcom(l), acct(2). 

BUGS 

The acjnem value for a short-lived command gives little information about the actual size of the com¬ 
mand, because acjnem may be incremented while a different command (e.g., the shell) is being executed 
by the process. 



AR(5) 


AR(5) 


NAME 

ar - archive file format 

DESCRIPTION 

The archive command ar is used to combine several files into one. Archives are used mainly as libraries to 
be searched by the link editor ld{l). 

A file produced by ar has a magic number at the start, followed by the constituent files, each preceded by a 
file header. The magic number is 0177545(octal) (it was chosen to be unlikely to occur anywhere else). 
The header of each file is 26 bytes long: 

#define ARM AG 0177545 
struct ar_hdr { 

char ar_name[14]; 
long ar_date; 
char ar_uid; 
char ar_gid; 
int ar_mode; 
long ar_size; 

}; 

Each file begins on a word boundary; a null byte is inserted between files if necessary. Nevertheless the 
size given reflects the actual size of the file exclusive of padding. 

Notice there is no provision for empty areas in an archive file. 

SEE ALSO 

ar(l),arcv(l), ld(l). 

BUGS 

The archive header structure is not compatible between the PDP-11 and the VAX-11/780, due to the differ¬ 
ent word sizes. See arcv{l) to convert between machines. 
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NAME 

checklist - list of file systems processed by fsck 
DESCRIPTION 

Checklist resides in directory /etc and contains a list of at most 15 special file names. Each special file 
name is contained on a separate line and corresponds to a file system. Each file system will then be auto¬ 
matically processed by the fsck(\M) command. 

SEE ALSO 

fsck(lM). 
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NAME 

core - format of core image file 
DESCRIPTION 

UNIX writes out a core image of a terminated process when any of various errors occur. See signal{2) for 
the list of reasons; the most common are memory violations, illegal instructions, bus errors, and user¬ 
generated quit signals. The core image is called core and is written in the process’s working directory (pro¬ 
vided it can be; normal access controls apply). A process with an effective user ID different from the real 
user ID will not produce a core image. 

The first section of the core image is a copy of the system’s per-user data for the process, including the reg¬ 
isters as they were at the time of the fault. The size of this section depends on the parameter usize, which is 
defined in /usr/include/sys/param h. The remainder represents the actual contents of the user’s core area 
when the core image was written. If the text segment is read-only and shared, or separated from data space, 
it is not dumped. 

The format of the information in the first section is described by the user structure of the system, defined in 
/usr/include/sys/user.h. The important stuff not detailed therein is the locations of the registers, which are 
outlined in /usr/include/sys/reg.h. 

SEE ALSO 

adb(l), crash(lM), sdb(l), setuid(2), signal(2). 
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NAME 

cpio - format of cpio archive 
DESCRIPTION 

The header structure, when the c option is not used, is: 
struct { 

short h_magic, 
h_dev, 
h_ino, 
h_mode, 
huid, 
h_gid, 
hnlink, 
hrdev, 
h_mtime[2], 
h_namesize, 
h_filesize[2]; 

char h_name[h_namesize rounded to word]; 

I Hdr; 

When the c option is used, the header information is described by the statement below: 

sscanf(Chdr,"%6o%6o%6o%6o%6o%6o%6o%6o%lllo%6o%6o%s", 
&Hdr.h_magic,&Hdr.h_dev,&Hdr h_ino,&Hdr hmode, 

&Hdr.h_uid,&Hdr.h_gid,&Hdr h_nlink,&Hdr.h_rdev, 
&Longtime,&Hdr.h_namesize,&Longfile,Hdr.h_name); 

Longtime and Longfile are equivalent to Hdr.hjntime and Hdr.h_filesize, respectively. The contents of 
each file is recorded in an element of the array of varying length structures, archive, together with other 
items describing the file. Every instance of hjnagic contains the constant 070707 (octal). The items 
h_dev through hjntime have meanings explained in stat{2). The length of the null-terminated path name 
h_name, including the null byte, is given by h_namesize. 

The last record of the archive always contains the name TRAILER!!!. Special files, directories, and the 
trailer are recorded with hjilesize equal to zero. 

SEE ALSO 

cpio(l), find(l), stat(2). 
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NAME 

dir - format of directories 

SYNOPSIS 

#mclude <sys/dir h> 

DESCRIPTION 

A directory behaves exactly like an ordinary file, save that no user may write into a directory. The fact that 
a file is a directory is indicated by a bit in the flag word of its i-node entry (see fs(5)). The structure of a 
directory entry as given in the include file is: 


#ifndef 

DIRSIZ 

#define 

DIRSIZ 14 

#endif 


struct 

1 

direct 

i 

ino t d ino; 


char d name[DIRSIZ]; 


}; 

By convention, the first two entries in each directory are for . and ... The first is an entry for the directory 
itself. The second is for the parent directory. The meaning of .. is modified for the root directory of the 
master file system; there is no parent, so .. has the same meaning as .. 

SEE ALSO 

fs(5). 
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NAME 

dump - incremental dump tape format 
DESCRIPTION 

The dump and restor commands are used to write and read incremental dump magnetic tapes. 

The dump tape consists of a header record, some bit mask records, a group of records describing file system 
directories, a group of records describing file system files, and some records describing a second bit mask. 

The header record and the first record of each description have the format described by the structure 
included by 

#include <dumprestor h> 

This include file has the following contents: 

#define NTREC 20 

#defineMLEN 16 
#define MSIZ 4096 

#define TS_TAPE 1 

#define TSJNODE 2 

#define TS_BITS 3 

#define TS_ADDR 4 

#define TS_END 5 

#defineTS CLRI 6 


#define MAGIC (int)60011 

#define CHECKSUM (int)84446 


struct 

spcl 


i 

int 

c type; 


time t 

c date; 


time t 

c ddate; 


int 

c volume; 


daddr t 

c tapea; 


ino t 

c inumber; 


int 

c magic; 


int 

c checksum; 


struct 

dinode c dinode; 


int 

c count; 

} spcl; 

char 

c_addr[BSIZE]; 

struct 

r 

idates 


i 

char 

id name[16]; 


char 

id incno; 


time t 

id ddate; 


}; 


NTREC is the number of 512 byte blocks in a physical tape record. MLEN is the number of bits in a bit map 
word. MSIZ is the number of bit map words. 

The TS_ entries are used in the cjype field to indicate what sort of header this is. The types and their 
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meanings are as follows: 

TS TYPE Tape volume label 

TS_INODE A file or directory follows. The c_dinode field is a copy of the disk inode and contains bits 
telling what sort of file this is. 

TS_BITS A bit mask follows. This bit mask has a one bit for each inode that was dumped. 

TS_ADDR A subblock to a file {TSJNODE). See the description of c_count below. 

TS_END End of tape record. 

TS_CLRI A bit mask follows. This bit mask contains a one bit for all inodes that were empty on the 
file system when dumped. 

MAGIC All header blocks have this number in cjnagic. 

CHECKSUM Header blocks checksum to this value. 

The fields of the header structure are as follows: 
c_type The type of the header, 

c date The date the dump was taken, 

c ddate The date the file system was dumped from. 

c_voluine The current volume number of the dump. 

c tapea The current block number of this record. This is counting 512 byte blocks, 

c inumber The number of the inode being dumped if this is of type TSJNODE. 

c magic This contains the value MAGIC above, truncated as needed. 

c_checksum This contains whatever value is needed to make the block sum to CHECKSUM. 
c dinode This is a copy of the inode as it appears on the file system. 

c count This is the count of characters following that describe the file. A character is zero if the 

block associated with that character was not present on the file system, otherwise the char¬ 
acter is non-zero. If the block was not present on the file system no block was dumped and 
it is replaced as a hole in the file. If there is not sufficient space in this block to describe all 
of the blocks in a file, TS_ADDR blocks will be scattered through the file, each one picking 
up where the last left off. 

c_addr This is the array of characters that is used as described above. 

Each volume except the last ends with a tapemark (read as an end of file). The last volume ends with a 
TS_END block and then the tapemark. 

The structure idates describes an entry of the file where dump history is kept. 

SEE ALSO 

dump(lM), restor(lM), fs(5). 
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NAME 

errfile - error-log file format 
DESCRIPTION 

When hardware errors are detected by the system, an error record is generated and passed to the error¬ 
logging daemon for recording in the error log for later analysis. The default error log is /usr/adm/errfile. 

The format of an error record depends on the type of error that was encountered. Every record, however, 
has a header with the following format: 

struct errhdr { 
int 
int 

time_t 

}; 

The permissible record types are as follows: 


#define E_GOTS 

010 

/* Start for UNIX 3.0*/ 

#define E_GORT 

on 

/* Start for UNIX/RT */ 

#define E_STOP 

012 

/* Stop */ 

#define E_TCHG 

013 

/* Time change */ 

#define E_CCHG 

014 

/* Configuration change */ 

#define E BLK 

020 

/* Block device error */ 

#define E_STRAY 

030 

/* Stray interrupt */ 

#define E_PRTY 

031 

/* Memory parity */ 


Some records in the error file are of an administrative nature. These include the 
entered into the file when logging is activated, the stop record that is written if the 
“gracefully”, and the time-change record that is used to account for changes in the 
These records have the following formats: 


struct estart { 

struct errhdr 

e hdr; 

/* record header */ 

int 

e cpu; 

/* CPU type */ 

int 

e mmr3; 

/* contents mem mgmt reg 3 */ 

long 

e syssize; 

/* 11/70 system memory size */ 

int 

1: 

e bconf; 

/* block dev configuration */ 

struct eend { 

struct errhdr 

1: 

e hdr; 

/* record header */ 

struct etimchg { 

struct errhdr 

e hdr; 

/* record header */ 

time t 

e ntime; 

/* new time */ 


}; 

Stray interrupts cause a record with the following format to be logged in the file: 
struct estray { 

struct errhdr e_hdr; /* record header */ 

physadr e_saddr; /* stray loc or device addr */ 

int e_sbacty; /* active block devices */ 


startup record that is 
daemon is terminated 
system’s time-of-day. 


e_type; /* record type */ 

e_len; /* bytes in record (inc hdr) */ 

e_time; /* time of day */ 
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Memory subsystem error on 11/70 processors cause the following record to be generated: 

struct eparity { 

struct errhdr e_hdr; /* record header */ 

int ejDarTeg[4]; /* memory subsys registers */ 

}; 

Error records for block devices have the following format: 

struct eblock { 

struct errhdr e_hdr; 

dev_t e_dev; 

physadr e_regloc; 

int e_bacty; 

struct iostat { 
long io_ops; 

long io_misc; 

unsigned io_unlog; 

} e_stats; 

int e_bflags; 

int e_cyloff; 

daddr_t e_bnum; 

unsigned e_bytes; 

long e_memadd; 

unsigned e_rtry; 

int e_nreg; 

}; 

The following values are used in the ejyflags word: 


#define E_WRITE 

0 

/* write operation */ 

#define E_READ 

1 

/* read operation */ 

#define E NOIO 

02 

/* no I/O pending */ 

#define E_PHYS 

04 

/* physical I/O */ 

#define E MAP 

010 

/* Unibus map in use */ 

#define E ERROR 

020 

/* I/O failed */ 


The “true” major device numbers that identify the failing device are as follows: 

#define RKO 0 

#define RPO 1 

#define RFO 2 

#define TMO 3 

#define TCO 4 

#define HPO 5 

#define HTO 6 

#define HSO 7 

SEE ALSO 

errdemon(lM). 


/* record header */ 

/* "true" major + minor dev no */ 
/* controller address */ 

/* other block I/O activity */ 

h number read/writes */ 

/* number "other" operations */ 

/* number unlogged errors */ 

/* read/write, error, etc */ 

/* logical dev start cyl */ 

/* logical block number */ 

/* number bytes to transfer */ 

/* buffer memory address */ 

/* number retries */ 

/* number device registers */ 
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NAME 

file system - format of system volume 
SYNOPSIS 

#mclude <sys/filsys h> 

#mclude <sys/types h> 

#include <sys/param.h> 


DESCRIPTION 

Every file system storage volume (e.g., RP04 disk) has a common format for certain vital information. 
Every such volume is divided into a certain number of 256 word (512 byte) blocks. Block 0 is unused and 
is available to contain a bootstrap program or other information. 

Block 1 is the super-block. Starting from its first word, the format of a super-block is: 


/* 

* Structure of the super-block 

*1 

struct filsys 

{ 


ushort 

s isize; 

/* 

daddr t 

s fsize; 

/* 

short 

s nfree; 

/* 

daddr t 

s_free[NICFREE]; 

/* 

short 

s ninode; 

/* 

ino t 

s_inode[NICINOD]; 

/* 

char 

s flock; 

/* 

char 

s ilock; 

/* 

char 

s fmod; 

/* 

char 

s ronly; 

/* 

time t 

s time; 

/* 

short 

s dinfo[4]; 

/* 

daddr t 

s tfree; 

/* 

ino t 

s tinode; 

/* 

char 

s fname[6]; 

/* 

char 

s fpack[6]; 

/* 


}; 


size in blocks of i-list */ 

size in blocks of entire volume */ 

number of addresses in s_free */ 

free block list */ 

number of i-nodes in s_inode */ 

free i-node list */ 

lock during free list manipulation */ 

lock during i-list manipulation */ 

super block modified flag */ 

mounted read-only flag */ 

last super block update */ 

device information */ 

total free blocks*/ 

total free inodes */ 

file system name */ 

file system pack name */ 


Sjsize is the address of the first data block after the i-list; the i-list starts just after the super-block, namely 
in block 2; thus the i-list is s_isiz.e-2 blocks long. SJ'siz.e is the first block not potentially available for 
allocation to a file. These numbers are used by the system to check for bad block numbers; if an “impossi¬ 
ble” block number is allocated from the free list or is freed, a diagnostic is written on the on-line console. 
Moreover, the free array is cleared, so as to prevent further allocation from a presumably corrupted free list. 

The free list for each volume is maintained as follows. The s_free array contains, in sJreelX], 
sJreelsjifree-X], up to 49 numbers of free blocks. 5_/ree[0] is the block number of the head of a chain of 
blocks constituting the free list. The first long in each free-chain block is the number (up to 50) of free- 
block numbers listed in the next 50 longs of this chain member. The first of these 50 blocks is the link to 
the next member of the chain. To allocate a block: decrement sjifree, and the new block is 
sjree{s_nfree]. If the new block number is 0, there are no blocks left, so give an error. If sjifree became 
0, read in the block named by the new block number, replace sjifree by its first word, and copy the block 
numbers in the next 50 longs into the s_free array. To free a block, check if sjifree is 50; if so, copy 
sjifree and the s_free array into it, write it out, and set sjifree to 0. In any event set syree[sjifree] to the 
freed block’s number and increment sjifree. 

Sjfree is the total free blocks available in the file system. 
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Sjiinode is the number of free i-numbers in the sjnode array. To allocate an i-node: if sjiinode is greater 
than 0, decrement it and return s_inode[s_mnode]. If it was 0, read the i-list and place the numbers of all 
free inodes (up to 100) into the sjnode array, then try again. To free an i-node, provided sjiinode is less 
than 100, place its number into s_inode[sjiinode] and increment sjiinode. If sjiinode is already 100, do 
not bother to enter the freed i-node into any table. This list of i-nodes is only to speed up the allocation pro¬ 
cess; the information as to whether the inode is really free or not is maintained in the inode itself. 

Sjinode is the total free inodes available in the file system. 

SJiock and sjlock are flags maintained in the core copy of the file system while it is mounted and their 
values on disk are immaterial. The value of sjmod on disk is likewise immaterial; it is used as a flag to 
indicate that the super-block has changed and should be copied to the disk during the next periodic update 
of file system information. 

S_ronly is a read-only flag to indicate write-protection. 

Sjime is the last time the super-block of the file system was changed, and is a double-precision representa¬ 
tion of the number of seconds that have elapsed since 00:00 Jan. 1, 1970 (GMT). During a reboot, the 
sjime of the super-block for the root file system is used to set the system’s idea of the time. 

SJname is the name of the file system and sjpack is the name of the pack. 

I-numbers begin at 1, and the storage for i-nodes begins in block 2. Also, i-nodes are 64 bytes long, so 8 of 
them fit into a block. Therefore, i-node i is located in block (/+15)/8, and begins 64x((/+15) (mod 8)) bytes 
from its start. I-node 1 is reserved for future use. I-node 2 is reserved for the root directory of the file sys¬ 
tem, but no other i-number has a built-in meaning. Each i-node represents one file. For the format of an 
inode and its flags, see inode(5). 

FILES 

/usr/include/sys/filsys h 
/usr/include/sys/stat.h 

SEE ALSO 

fsck(lM), fsdb(lM), mkfs(lM), inode(5). 
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NAME 

fspec - format specification in text files 
DESCRIPTION 

It is sometimes convenient to maintain text files on UNIX with non-standard tabs, (i.e., tabs which are not 
set at every eighth column). Such files must generally be converted to a standard format, frequently by 
replacing all tabs with the appropriate number of spaces, before they can be processed by UNIX commands. 
A format specification occurring in the first line of a text file specifies how tabs are to be expanded in the 
remainder of the file. 

A format specification consists of a sequence of parameters separated by blanks and surrounded by the 
brackets <: and :>. Each parameter consists of a keyletter, possibly followed immediately by a value. The 
following parameters are recognized: 

itabs The t parameter specifies the tab settings for the file. The value of tabs must be one of the 
following: 

1. a list of column numbers separated by commas, indicating tabs set at the specified 
columns; 

2. a - followed immediately by an integer n, indicating tabs at intervals of n columns; 

3. a - followed by the name of a “canned” tab specification. 

Standard tabs are specified by t-8, or equivalently, tl,9,17,25,etc. The canned tabs which are 
recognized are defined by the tabs{\) command. 

ssiz.e The s parameter specifies a maximum line size. The value of size must be an integer. Size 
checking is performed after tabs have been expanded, but before the margin is prepended. 

mmargin The m parameter specifies a number of spaces to be prepended to each line. The value of 
margin must be an integer. 

d The d parameter takes no value. Its presence indicates that the line containing the format 

specification is to be deleted from the converted file. 

e The e parameter takes no value. Its presence indicates that the current format is to prevail 

only until another format specification is encountered in the file. 

Default values, which are assumed for parameters not supplied, are t-8 and mO. If the s parameter is not 
specified, no size checking is performed. If the first line of a file does not contain a format specification, the 
above defaults are assumed for the entire file. The following is an example of a line containing a format 
specification: 

* <:t5,10,15 s72:> * 

If a format specification can be disguised as a comment, it is not necessary to code the d parameter. 

Several UNIX commands correctly interpret the format specification for a file. Among them is gath (see 
send{lC)) which may be used to convert files to a standard format acceptable to other UNIX commands. 

SEE ALSO 

ed(l), reform(l), send(lC), tabs(l). 
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NAME 

gps - graphical primitive string, format of graphical files 
DESCRIPTION 

GPS is a format used to store graphical data. Several routines have been developed to edit and display GPS 

files on various devices. Also, higher level graphics programs such as plot (in 5far(lG)) and vtoc (in 

toc(lG)) produce GPS format output files. 

A GPS is composed of five types of graphical data or primitives. 

GPS PRIMITIVES 

lines The lines primitive has a variable number of points from which zero or more connected line 

segments are produced. The first point given produces a move to that location. (A move is a 
relocation of the graphic cursor without drawing.) Successive points produce line segments 
from the previous point. Parameters are available to set color, weight, and style (see below). 

arc The arc primitive has a variable number of points to which a curve is fit. The first point pro¬ 

duces a move to that point. If only two points are included a line connecting the points will 
result, if three points a circular arc through the points is drawn, and if more than three, lines 
connect the points. (In the future, a spline will be fit to the points if they number greater than 
three.) Parameters are available to set color, weight, and style. 

text The text primitive draws characters. It requires a single point which locates the center of the 

first character to be drawn. Parameters are color, font, textsize, and textangle. 

hardware The hardware primitive draws hardware characters or gives control commands to a hardware 
device. A single point locates the beginning location of the hardware string. 

comment A comment is an integer string that is included in a GPS file but causes nothing to be displayed. 
All GPS files begin with a comment of zero length. 

GPS PARAMETERS 

color Color is an integer value set for arc, lines, and text primitives. 

weight Weight is an integer value set for arc and lines primitives to indicate line thickness. The value 
0 is narrow weight, 1 is bold, and 2 is medium weight. 

style Style is an integer value set for lines and arc primitives to give one of the five different line 

styles that can be drawn on Tektronix 4010 series storage tubes. They are: 

0 solid 

1 dotted 

2 dot dashed 

3 dashed 

4 long dashed 

font An integer value set for text primitives to designate the text font to be used in drawing a char¬ 

acter string. (Currently font is expressed as a four-bit weight value followed by a four-bit style 
value.) 

textsize Textsize is an integer value used in text primitives to express the size of the characters to be 
drawn. Textsize represents the height of characters in absolute universe-units and is stored at 
one-fifth this value in the size-orientation (i'o) word (see below). 

textangle Textangle is a signed integer value used in text primitives to express rotation of the character 
string around the beginning point. Textangle is expressed in degrees from the positive x-axis 
and can be a positive or negative value. It is stored in the size-orientation {so) word as a value 
256/360 of it’s absolute value. 

ORGANIZATION 

GPS primitives are organized internally as follows: 
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lines 

arc 

text 

hardware 

comment 


cw points 
cw points 5W 
cw point so [string ] 
cw point [string ] 
cw [string ] 


cw Cw is the control word and begins all primitives. It consists of four bits that contain a 

primitive-type code and twelve bits that contain the word-count for that primitive. 

point(s) Point(s) is one or more pairs of integer coordinates. Text and hardware primitives only 
require a single point. Point(s) are values within a Cartesian plane or universe having 64K 
(-32K to +32K) points on each axis. 

sw 5w is the style-word and is used in lines, arc, and text primitives. The first eight bits contain 

color information. In arc and lines the last eight bits are divided as four bits weight and four 
bits style. In the text primitive the last eight bits of contain the font. 

so So is the size-orientation word used in text primitives. The first eight bits contain text size and 

the remaining eight bits contain text rotation. 

string String is a null-terminated character string. If the string does not end on a word boundary an 
additional null is added to the GPS file to insure word-boundary alignment. 

SEE ALSO 

graphics(lG). 
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NAME 

group - group file 
DESCRIPTION 

Group contains for each group the following information: 

group name 
encrypted password 
numerical group ID 

comma-separated list of all user allowed in the group 

This is an ASCII file. The fields are separated by colons; each group is separated from the next by a new- 
line. If the password field is null, no password is demanded. 

This file resides in directory /etc. Because of the encrypted passwords, it can and does have general read 
permission and can be used, for example, to map numerical group ID’s to names. 

FILES 

/etc/group 
SEE ALSO 

newgrp(l), passwd(l), crypt(3C), passwd(5). 
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NAME 

inittab - control information for ink 
DESCRIPTION 

When a state is entered, init reads the file /etc/inittab. Lines in this file have the format: 
state:id:flags:command 

All lines in which the state field match m/r’s current state are recognized. If a process is active under the 
same two character id as a recognized line, it may be terminated (signal 15), killed (signal 9), or both by 
including the flags t and k in the order desired. The signal is sent to all processes in the process group 
associated with the id. The command field is saved for later execution. Thtflag c requires the command 
to be continuously reinvoked whenever the process with that id dies. Otherwise the command is invoked a 
maximum of one time in the current state. 

FILES 

/etc/inittab 
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NAME 

inode - format of an inode 
SYNOPSIS 

#include <sys/types h> 

#mclude <sys/ino.h> 

DESCRIPTION 

An i-node for a plain file or directory in a file system has the following structure defined by <sys/ino h>. 


struct sysinfo { 

time_t cpu[3]; 

#define CPUJDLE 0 

#define CPU_USER 1 

#define CPU_KERNAL 2 

time_t wait[3]; 

#define W_IO 0 

#define W SWAP 1 


#define W PI02 


long 

bread; 

long 

bwrite; 

long 

Iread; 

long 

Iwrite; 

long 

swapin; 

long 

swapout; 

long 

pswitch; 

long 

qswitch; 

long 

idle; 

long 

preempt; 

long 

syscall; 

long 

iget; 

long 

namei; 

long 

dirblk; 

long 

readch; 

long 

writech; 

long 

rcvint; 

long 

xmtint; 

long 

mdmint; 

long 

rawch; 

long 

canch; 

long 

outch; 


}; 


extern struct sysinfo sysinfo; 

struct syswait { 

short iowait; 
short swap; 
short physio; 

}; 


extern struct syswait syswait; 

For the meaning of the defined types offj and timej see typesil). 

FILES 


/usr/include/sys/ino.h 
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SEE ALSO 

stat(2), fs(5), types(7). 
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NAME 

master - master device information table 
DESCRIPTION 

This file is used by the config{\}A) program to obtain device information that enables it to generate the 
configuration files. The file consists of 3 parts, each separated by a line with a dollar sign ($) in column 1. 
Part 1 contains device information; part 2 contains names of devices that have aliases; part 3 contains tun¬ 
able parameter information. Any line with an asterisk (*) in column 1 is treated as a comment. 

Part 1 contains lines consisting of at least 10 fields and at most 13 fields, with the fields delimited by tabs 
and/or blanks: 

Field 1: device name (8 chars, maximum). 

Field 2: interrupt vector size (decimal, in bytes). 

Field 3: device mask (octal)“each ‘ ‘on’ ’ bit indicates that the handler exists: 

000100 initialization handler 
000040 power-failure handler 
000020 open handler 
000010 close handler 
000004 read handler 
000002 write handler 
000001 ioctl handler. 

Field 4: device type indicator (octal): 

000200 allow only one of these devices 
000100 suppress count field in the conf.c file 
000040 suppress interrupt vector 
000020 required device 
000010 block device 
000004 character device 
000002 floating vector 
000001 fixed vector. 

Field 5: handler prefix (4 chars, maximum). 

Field 6: device address size (decimal). 

Field 7: major device number for block-type device. 

Field 8: major device number for character-type device. 

Field 9: maximum number of devices per controller (decimal). 

Field 10: maximum bus request level (4 through 7). 

Fields 11-13: optional configuration table structure declarations (8 chars, maximum). 

Part 2 contains lines with 2 fields each: 

Field 1: alias name of device (8 chars, maximum). 

Field 2: reference name of device (8 chars, maximum; specified in part 1). 

Part 3 contains lines with 2 or 3 fields each: 

Field 1: parameter name (as it appears in description file; 20 chars, maximum) 

Field 2: parameter name (as it appears in the conf.c file; 20 chars, maximum) 

Field 3: default parameter value (20 chars, maximum; parameter specification is required if 

this field is omitted) 

Devices that are not interrupt-driven have an interrupt vector size of zero. The 040 bit in Field 4 causes 
conjigilM) to record the interrupt vector although the low.s (univec.c on the VAX-11/780) file will show 
no interrupt vector assignment at those locations (interrupts here will be treated as strays). 

SEE ALSO 

config(lM). 
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NAME 

mnttab - mounted file system table 

SYNOPSIS 

struct mnttab { 

char mt_dev[10]; 
char mt_filsys[10]; 
short mtro _flg; 
time t mt time; 

}; 

DESCRIPTION 

Mnttab resides in directory /etc and contains a table of devices mounted by the wow«r(lM) command. 

Each entry is 26 bytes in length; the first 10 bytes are the null-padded name of the place where the special 
file is mounted; the next 10 bytes represent the null-padded root name of the mounted special file; the 
remaining 6 bytes contain the mounted special file’s read/write permissions and the date on which it was 
mounted. 

The maximum number of entries in mnttab is based on the system parameter NMOUNT located in 
/usr/src/uts/cf/conf.c, which defines the number of allowable mounted special files. 

SEE ALSO 

mount(lM). 
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NAME 

passwd - password file 
DESCRIPTION 

Passwd contains for each user the following information: 

login name 
encrypted password 
numerical user ID 
numerical group ID 

GCOS job number, box number, optional GCOS user ID 
initial working directory 
program to use as Shell 

This is an ASCII file. Each field within each user’s entry is separated from the next by a colon. The GCOS 
field is used only when communicating with that system, and in other installations can contain any desired 
information. Each user is separated from the next by a new-line. If the password field is null, no password 
is demanded; if the Shell field is null, the Shell itself is used. 

This file resides in directory /etc. Because of the encrypted passwords, it can and does have general read 
permission and can be used, for example, to map numerical user ID’s to names. 

The encrypted password consists of 13 characters chosen from a 64 character alphabet (., /, 0-9, A-Z, a-z), 
except when the password is null in which case the encrypted password is also null. Password aging is 
effected for a particular user if his encrypted password in the password file is followed by a comma and a 
non-null string of characters from the above alphabet. (Such a string must be introduced in the first instance 
by the super-user.) The first character of the age, M say, denotes the maximum number of weeks for which 
a password is valid. A user who attempts to login after his password has expired will be forced to supply a 
new one. The next character, m say, denotes the minimum period in weeks which must expire before the 
password may be changed. The remaining characters define the week (counted from the beginning of 1970) 
when the password was last changed. (A null string is equivalent to zero.) M and m have numerical values 
in the range 0-63. If m = A/ = 0 (derived from the string . or ..) the user will be forced to change his pass¬ 
word the next time he logs in (and the “age” will disappear from his entry in the password file). If m > M 
(signified, e.g., by the string ./) only the super-user will be able to change the password. 

FILES 

/etc/passwd 
SEE ALSO 

login(l), passwd(l), a641(3C), crypt(3C), getpwent(3C), group(5). 
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NAME 

plot - graphics interface 
DESCRIPTION 

Files of this format are produced by routines described in plot(3X) and are interpreted for various devices 
by commands described in tplotilG). A graphics file is a stream of plotting instructions. Each instruction 
consists of an ASCII letter usually followed by bytes of binary information. The instructions are executed 
in order. A point is designated by four bytes representing the x and y values; each value is a signed integer. 
The last designated point in an 1, m, n, or p instruction becomes the “current point” for the next instruc¬ 
tion. 


Each of the following descriptions begins with the name of the corresponding routine in plot(3X). 

m move: The next four bytes give a new current point. 

n cont: Draw a line from the current point to the point given by the next four bytes. See tplot(lG). 

p point: Plot the point given by the next four bytes. 

1 line: Draw a line from the point given by the next four bytes to the point given by the following four 
bytes. 

t label: Place the following ASCII string so that its first character falls on the current point. The string is 
terminated by a new-line. 

e erase: Start another frame of output. 

f linemod: Take the following string, up to a new-line, as the style for drawing further lines. The styles 
are “dotted”, “solid”, “longdashed”, “shortdashed”, and “dotdashed”. Effective only for the 
-T4014 and -Tver options of tplot{lG) (Tektronix 4014 terminal and Versatec plotter). 

s space: The next four bytes give the lower left corner of the plotting area; the following four give the 
upper right corner. The plot will be magnified or reduced to fit the device as closely as possible. 

Space settings that exactly fill the plotting area with unity scaling appear below for devices supported by 

the filters of tplot{lG). The upper limit is just outside the plotting area. In every case the plotting area is 

taken to be square; points outside may be displayable on devices whose face is not square. 


DASI300 
DASI 300s 
DASI 450 
Tektronix 4014 
Versatec plotter 


space(0, 4096, 0, 4096); 
space(0, 4096, 0, 4096); 
space(0, 4096, 0, 4096); 
space(0, 3120, 0,3120); 
space(0, 2048, 0, 2048); 


SEE ALSO 

graph(lG), tplot(lG), plot(3X), gps(5), term(7). 
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NAME 

pnch - file format for card images 
DESCRIPTION 

The PNCH format is a convenient representation for files consisting of card images in an arbitrary code. 

A PNCH file is a simple concatenation of card records. A card record consists of a single control byte fol¬ 
lowed by a variable number of data bytes. The control byte specifies the number (which must lie in the 
range 0-80) of data bytes that follow. The data bytes are 8-bit codes that constitute the card image. If there 
are fewer than 80 data bytes, it is understood that the remainder of the card image consists of trailing 
blanks. 



PROFILE(5) 


PR0FILE(5) 


NAME 

profile - setting up an environment at login time 
DESCRIPTION 

If your login directory contains a file named .profile, that file will be executed (via the shell’s exec .profile) 
before your session begins; .profiles are handy for setting exported environment variables and terminal 
modes. If the file /etc/profile exists, it will be executed for every user before the .profile. The following 
example is typical (except for the comments): 

# Make some environment variables global 
export MAIL PATH TERM 

# Set file creation mask 
umask 22 

# Tell me when new mail comes in 
MAIL=/usr/mail/myname 

# Add my /bin directory to the shell search sequence 
PATH=$PATH:$HOME/bin 


# Set terminal type 


echo "terminal: \c" 


read TERM 


case $TERM in 


300) 

stty cr2 nlO tabs; tabs;; 

300s) 

stty cr2 nlO tabs; tabs;; 

450) 

stty cr2 nlO tabs; tabs;; 

hp) 

stty crO nlO tabs; tabs;; 

745 1 735) 

stty crl nil -tabs; TERM=745;; 

43) 

stty crl nlO-tabs;; 

4014 Itek) 

stty crO nlO -tabs ffl; TERM=4014; echo "\33; 

*) 

echo "$TERM unknown";; 


esac 


FILES 

$HOME/.profile 

/etc/profile 

SEE ALSO 

env(l), login(l), mail(l), sh(l), stty(l), su(l), environ(7), term(7). 
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NAME 

sccsfile - format of SCCS file 

DESCRIPTION 

An SCCS file is an ASCII file. It consists of six logical parts: the checksum, the delta table (contains infor¬ 
mation about each delta), user names (contains login names and/or numerical group IDs of users who may 
add deltas), flags (contains definitions of internal keywords), comments (contains arbitrary descriptive 
information about the file), and the body (contains the actual text lines intermixed with control lines). 

Throughout an SCCS file there are lines which begin with the ASCII SOH (start of heading) character (octal 
001). This character is hereafter referred to as the control character and will be represented graphically as 
@. Any line described below which is not depicted as beginning with the control character is prevented 
from beginning with the control character. 

Entries of the form DDDDD represent a five digit string (a number between 00000 and 99999). 

Each logical part of an SCCS file is described in detail below. 

Checksum 

The checksum is the first line of an SCCS file. The form of the line is: 

@hDDDDD 

The value of the checksum is the sum of all characters, except those of the first line. The @h pro¬ 
vides a magic number of (octal) 064001. 

Delta table 

The delta table consists of a variable number of entries of the form: 

@s DDDDD/DDDDD/DDDDD 

@d <type><SCCS ID> yr/mo/dahr:mi:se <pgmr> DDDDD DDDDD 
@i DDDDD ... 

@x DDDDD ... 

@g DDDDD ... 

@m <MR number> 


@c <comments>... 


@e 

The first line (@s) contains the number of lines inserted/deleted/unchanged respectively. The sec¬ 
ond line (@d) contains the type of the delta (currently, normal: D, and removed: R), the SCCS ID 
of the delta, the date and time of creation of the delta, the login name corresponding to the real 
user ID at the time the delta was created, and the serial numbers of the delta and its predecessor, 
respectively. 

The @i, @x, and @g lines contain the serial numbers of deltas included, excluded, and ignored, 
respectively. These lines are optional. 

The @m lines (optional) each contain one MR number associated with the delta; the @c lines con¬ 
tain comments associated with the delta. 


The @e line ends the delta table entry. 
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User names 

The list of login names and/or numerical group IDs of users who may add deltas to the file, sepa¬ 
rated by new-lines. The lines containing these login names and/or numerical group IDs are sur¬ 
rounded by the bracketing lines @u and @U. An empty list allows anyone to make a delta. 

Flags 

Keywords used internally (see admin{\) for more information on their use). Each flag line takes 
the form: 


@f <flag> <optional text> 

The following flags are defined: 


@ft 

<type of program> 

@f V 

<program name> 

@fi 


@fb 


@f m 

<module name> 

@ff 

<floor> 

@f c 

<ceiling> 

@fd 

<default-sid> 

@f n 


@fj 


@fl 

<lock-reIeases> 

@f q 

<user defined> 


The t flag defines the replacement for the %Y% identification keyword. The v flag controls 
prompting for MR numbers in addition to comments; if the optional text is present it defines an 
MR number validity checking program. The i flag controls the warning/error aspect of the “No id 
keywords” message. When the i flag is not present, this message is only a warning; when the i 
flag is present, this message will cause a “fatal” error (the file will not be gotten, or the delta will 
not be made). When the b flag is present the -b keyletter may be used on the get command to 
cause a branch in the delta tree. The m flag defines the first choice for the replacement text of the 
%M% identification keyword. The f flag defines the “floor” release; the release below which no 
deltas may be added. The c flag defines the “ceiling” release; the release above which no deltas 
may be added. The d flag defines the default SID to be used when none is specified on a get com¬ 
mand. The n flag causes delta to insert a “null” delta (a delta that applies no changes) in those 
releases that are skipped when a delta is made in a new release (e.g., when delta 5.1 is made after 
delta 2.7, releases 3 and 4 are skipped). The absence of the n flag causes skipped releases to be 
completely empty. The j flag causes get to allow concurrent edits of the same base SID. The 1 flag 
defines a list of releases that are locked against editing {get{\) with the -e keyletter). The q flag 
defines the replacement for the %Q% identification keyword. 

Comments 

Arbitrary text surrounded by the bracketing lines @t and @T. The comments section typically 
will contain a description of the file’s purpose. 

Body 

The body consists of text lines and control lines. Text lines don’t begin with the control character, 
control lines do. There are three kinds of control lines: insert, delete, and end, represented by: 

@IDDDDD 
@D DDDDD 
@E DDDDD 


respectively. The digit string is the serial number corresponding to the delta for the control line. 
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SEE ALSO 

admin(l), delta(l), get(l), prs(l). 

Source Code Control System User’s Guide by L. E. Bonanni and C. A. Salemi. 
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NAME 

tp - magnetic tape format 
DESCRIPTION 

The command tp{\) dumps files to and extracts files from magtape. 

Block zero contains a copy of a stand-alone bootstrap program; see tapebooti%). 

Blocks 1 through 62 contain a directory of the tape. There are 496 entries in the directory; 8 entries per 
block; 64 bytes per entry. Each entry has the following format: 

struct tpent { 

char pathnam[32]; 

short mode; 

char uid; 

char uid; 

char gid; 

char spare; 

char sizeO; 

short size2; 

long time; 

short tapea; 

short unused[8]; 

short cksum; 

} 

The pathnam entry is the path name of the file when put on the tape. If the path name starts with a zero 
word, the entry is empty. It is at most 32 bytes long and ends in a null byte. Mode, uid, gid, the sizes and 
time modified are the same as described under i-nodes (fs(5)). The tape address is the tape block number of 
the start of the contents of the file. Every file starts on a block boundary. The file occupies (size-i-511)/512 
blocks of continuous tape. The checksum entry has a value such that the sum of the 32 words of the direc¬ 
tory entry is zero. 

Blocks 63 on are available for file storage. 

A fake entry has a size of zero. See tp(l). 

SEE ALSO 

cpio(l), tp(l), fs(5), tapeboot(8). 


/* tape address */ 
/* check sum */ 
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NAME 

utmp, wtmp - utmp and wtmp entry format 
DESCRIPTION 

The files utmp and wtmp hold user and accounting information for use by commands such as who(l), 
acctconl (see acctcon(\M)), and login{l). They have the following structure, as defined by <utmp h>: 

struct utmp 

{ 

char 
char 
long 

1 ; 

FILES 

/etc/utmp 
/usr/adm/wtmp 
/usr/include/utmp h 

SEE ALSO 

acctcon(lM), login(l), who(l), write(l). 


ut_line[8]; /* tty name */ 

ut_name[8]; /* login name */ 

ut_time; /* time on */ 
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NAME 

intro - introduction to games 
DESCRIPTION 

This section describes the recreational and educational programs found in the directory /usr/games. The 
availability of these programs may vary from system to system. A suggested procedure is to disallow their 
use during business hours by means of cron(lM). 
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NAME 

arithmetic - provide drill in number facts 
SYNOPSIS 

/usr/games/arithmetic [ +-x/ ] [ range ] 

DESCRIPTION 

Arithmetic types out simple arithmetic problems, and waits for an answer to be typed in. If the answer is 
correct, it types back “Right!”, and a new problem. If the answer is wrong, it replies “What?”, and waits 
for another answer. Every twenty problems, it publishes statistics on correctness and the time required to 
answer. 

To quit the program, type an interrupt (delete). 

The first optional argument determines the kind of problem to be generated; +, -, x, and / respectively cause 
addition, subtraction, multiplication, and division problems to be generated. One or more characters can be 
given; if more than one is given, the different types of problems will be mixed in random order; default is 

+-. 

Range is a decimal number; all addends, subtrahends, differences, multiplicands, divisors, and quotients 
will be less than or equal to the value of range. Default range is 10. 

At the start, all numbers less than or equal to range are equally likely to appear. If the respondent makes a 
mistake, the numbers in the problem which was missed become more likely to reappear. 

As a matter of educational philosophy, the program will not give correct answers, since the learner should, 
in principle, be able to calculate them. Thus the program is intended to provide drill for someone just past 
the first learning stage, not to teach number facts de novo. For almost all users, the relevant statistic should 
be time per problem, not percent correct. 
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NAME 

back - the game of backgammon 

SYNOPSIS 

/usr/games/back 

DESCRIPTION 

Back is a program which provides a partner for the game of backgammon. It is designed to play at three 
different levels of skill, one of which you must select. In addition to selecting the opponent’s level, you 
may also indicate that you would like to roll your own dice during your turns (for the superstitious players). 
You will also be given the opportunity to move first. The practice of each player rolling one die for the first 
move is not incorporated. 

The points are numbered 1-24, with 1 being white’s extreme inner table, 24 being brown’s inner table, 0 
being the bar for removed white pieces and 25 the bar for brown. For details on how moves are expressed, 
type y when back asks “Instructions?” at the beginning of the game. When hack first asks “Move?”, 
type ? to see a list of move options other than entering your numerical move. 

When the game is finished, back will ask you if you want the log. If you respond with y, back will attempt 
to append to or create a file back log in the current directory. 

FILES 

/usr/games/lib/backrules rules file 

/tmp/b* log temp file 

back.log log file 

BUGS 

The only level really worth playing is “expert”, and it only plays the forward game. 

Back will complain loudly if you attempt to make too many moves in a turn, but will become very silent if 
you make too/ew. 

Doubling is not implemented. 
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NAME 

bj - the game of black jack 

SYNOPSIS 

/usr/games/bj 

DESCRIPTION 

Bj is a serious attempt at simulating the dealer in the game of black jack (or twenty-one) as might be found 
in Reno. The following rules apply: 

The bet is $2 every hand. 

A player “natural” (blackjack) pays $3. A dealer natural loses $2. Both dealer and player naturals 
is a “push” (no money exchange). 

If the dealer has an ace up, the player is allowed to make an “insurance” bet against the chance of a 
dealer natural. If this bet is not taken, play resumes as normal. If the bet is taken, it is a side bet 
where the player wins $2 if the dealer has a natural and loses $1 if the dealer does not. 

If the player is dealt two cards of the same value, he is allowed to “double”. He is allowed to play 
two hands, each with one of these cards. (The bet is doubled also; $2 on each hand.) 

If a dealt hand has a total of ten or eleven, the player may “double down”. He may double the bet 
($2 to $4) and receive exactly one more card on that hand. 

Under normal play, the player may “hit” (draw a card) as long as his total is not over twenty-one. If 
the player “busts” (goes over twenty-one), the dealer wins the bet. 

When the player “stands” (decides not to hit), the dealer hits until he attains a total of seventeen or 
more. If the dealer busts, the player wins the bet. 

If both player and dealer stand, the one with the largest total wins. A tie is a push. 

The machine deals and keeps score. The following questions will be asked at appropriate times. Each 
question is answered by y followed by a new-line for “yes”, or just new-line for “no”. 

? (means, ‘ ‘do you want a hit?”) 

Insurance? 

Double down? 


Every time the deck is shuffled, the dealer so states and the “action” (total bet) and “standing” (total won 
or lost) is printed. To exit, hit the interrupt key (DEL) and the action and standing will be printed. 
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NAME 

chess - the game of chess 

SYNOPSIS 

/usr/games/chess 

DESCRIPTION 

Chess is a computer program that plays class D chess. Moves may be given either in standard (descriptive) 
notation or in algebraic notation. The symbol + must be placed at the end of a line when the move on that 
line places the opponent’s king in check, o-o and o-o-o specify castling, king side or queen side, respec¬ 
tively. 

The user is prompted for a move or command by a *. To play black, type first at the onset of the game. To 
print a copy of the board in play, type a carriage return only. Each move is echoed in the appropriate nota¬ 
tion, followed by the program’s reply. Near the middle and end games, the program can take considerable 
time in computing its moves. 

A ? or help may be typed to get a help message that briefly describes the possible commands. 

Execute /usr/games/chessrules for further explanation. 

FILES 

/usr/lib/book opening “book” 

/usr/games/chessrules executable “rules” file 

DIAGNOSTICS 

The most cryptic diagnostic is “eh?” which means that the input was syntactically incorrect. 

BUGS 

Pawns may be promoted only to queens. 



CRAPS(6) 


CRAPS(6) 


NAME 

craps - the game of craps 

SYNOPSIS 

/usr/games/craps 

DESCRIPTION 

Craps is a form of the game of craps that is played in Las Vegas. The program simulates the roller, while 
the user (the player) places bets. The player may choose, at any time, to bet with the roller or with the 
House. A bet of a negative amount is taken as a bet with the House, any other bet is a bet with the roller. 

The player starts off with a “bankroll” of $2,000. 

The program prompts with: 
bet? 

The bet can be all or part of the player’s bankroll. Any bet over the total bankroll is rejected and the pro¬ 
gram prompts with “bet?” until a proper bet is made. 

Once the bet is accepted, the roller throws the dice. The following rules apply (the player wins or loses 
depending on whether the bet is placed with the roller or with the House; the odds are even). The first roll 
is the roll immediately following a bet. 

1. On the first roll: 

7 or 11 wins for the roller; 

2, 3, or 12 wins for the House; 

any other number is the point, roll again (Rule 2 applies). 


2. On subsequent rolls: 
point 
7 

any other number 


roller wins; 
House wins; 
roll again. 


If a player loses the entire bankroll, the House will offer to lend the player an additional $2,000. The pro¬ 
gram will prompt: 

marker? 

A “yes” (or “y”) consummates the loan. Any other reply terminates the game. 


If a player owes the House money, the House reminds the player, before a bet is placed, how many markers 
are outstanding. 


If, at any time, the bankroll of a player who has outstanding markers exceeds $2,000, the House asks: 

Repay marker? 

A reply of “yes” (or “y”) indicates the player’s willingness to repay the loan. If only 1 marker is out¬ 
standing, it is immediately repaid. However, if more than 1 marker are outstanding, the House asks: 

How many? 

markers the player would like to repay. If an invalid number is entered (or just a carriage return), an appro¬ 
priate message is printed and the program will prompt with “How many?” until a valid number is entered. 


If a player accumulates 10 markers (a total of $20,000 borrowed from the House), the program informs the 
player of the situation and exits. 
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Should the bankroll of a player who has outstanding markers exceed $50,000, the total amount of money 
borrowed will be automatically repaid to the House. 

Any player who accumulates $100,000 or more breaks the bank. The program then prompts: 

New game? 

to give the House a chance to win back its money. 

Any reply other than “yes” is considered “no” (except in the case of “bet?” or “How many?”). To exit, 
send an interrupt (break), DEL, or control-D. The program will indicate whether the player won, lost, or 
broke even. 

MISCELLANEOUS 

The random number generator for the die numbers uses the seconds from the time of day. Depending on 
system usage, these numbers, at times, may seem strange but occurrences of this type in a real dice situation 
are not uncommon. 
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NAME 

hangman - guess the word 
SYNOPSIS 

/usr/games/hangman [ arg ] 

DESCRIPTION 

Hangman chooses a word at least seven letters long from a dictionary. The user is to guess letters one at a 
time. 

The optional argument arg names an alternate dictionary. 

FILES 

/usr/lib/w2006 

BUGS 

Hyphenated compounds are run together. 
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NAME 

maze - generate a maze 

SYNOPSIS 

/usr/games/maze 

DESCRIPTION 

Maze asks a few questions and then prints a maze. 

BUGS 

Some mazes (especially small ones) have no solutions. 
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NAME 

moo - guessing game 

SYNOPSIS 

/usr/games/moo 

DESCRIPTION 

Moo is a guessing game imported from England. The computer picks a number consisting of four distinct 
decimal digits. The player guesses four distinct digits being scored on each guess. A “cow” is a correct 
digit in an incorrect position. A ‘ ‘bull’ ’ is a correct digit in a correct position. The game continues until the 
player guesses the number (a score of four bulls). 
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NAME 

quiz - test your knowledge 
SYNOPSIS 

/usr/games/quiz [ -i file ] [ -t ] [ category 1 category2 ] 

DESCRIPTION 

Quiz gives associative knowledge tests on various subjects. It asks items chosen from category! and 
expects answers from category2, or vice versa. If no categories are specified, quiz gives instructions and 
lists the available categories. 

Quiz tells a correct answer whenever you type a bare new-line. At the end of input, upon interrupt, or when 
questions run out, quiz reports a score and terminates. 

The -t flag specifies “tutorial” mode, where missed questions are repeated later, and material is gradually 
introduced as you learn. 

The -i flag causes the named file to be substituted for the default index file. The lines of these files have the 
syntax: 

line = category new-line I category : line 
category = alternate I category I alternate 
alternate = empty I alternate primary 
primary = character I [ category ] I option 
option = { category } 

The first category on each line of an index file names an information file. The remaining categories specify 
the order and contents of the data in each line of the information file. Information files have the same syn¬ 
tax. Backslash \ is used as with 5/i(l) to quote syntactically significant characters or to insert transparent 
new-lines into a line. When either a question or its answer is empty, quiz will refrain from asking it. 

FILES 

/usr/games/lib/quiz/index 

/usr/games/lib/quiz/* 

BUGS 

The construct “a I ab” doesn’t work in an information file. Use “a{b}”. 
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NAME 

reversi - a game of dramatic reversals 
SYNOPSIS 

/usr/games/reversi [ [ -r^jile ] 

DESCRIPTION 

Reversi (also known as “friends”, “Chinese friends” and “Othello”) is played on an 8 by 8 board using 
two-sided tokens. Each player takes his turn by placing a token with his side up in an empty square. Dur¬ 
ing the first four turns, players may only place tokens in the four central squares of the board. Subse¬ 
quently, with each turn, a player must capture one or more of his opponent’s tokens. He does this by plac¬ 
ing one of his tokens such that it and another of his tokens embrace a solid line of his opponent’s horizon¬ 
tally, vertically or diagonally. Captured tokens are flipped over and thus can be re-captured. If a player 
cannot outflank his opponent he forfeits his turn. The play continues until the board is filled or until no 
more outflanking is possible. 

In this game, your tokens are asterisks (*) and the machine’s are at-signs (@). You move by typing in the 
row and column at which you want to place your token as two digits (1-8), optionally separated by blanks 
or tabs. You can also type in: 

c to continue the game after hitting break (this is only necessary if you interrupt the 

machine while it is deliberating), 

g « to start reversi playing against itself for the next n moves (or until the break key is hit), 

n to stop printing the board after each move, 

o to start it up again, 

p to print the board regardless, 

q to quit (without dishonor), 

s to print the score, and, as always, 

! to escape to the shell. Control-d gets you back. 

Reversi also recognizes several commands which are valid only at the start of the game, before any moves 
have been made. They are: 

f to let the machine go first. 

h n to ask for a handicap of from one to four corner squares. If you’re really good, you can 
give the machine a handicap by typing a negative number. 

1 n to set the amount of look-ahead used by the machine in searching for moves. Zero means 
none at all. Four is the default. Greater than six means you may fall asleep waiting for 
the machine to move. 

in to tell reversi that you will only need n seconds to consider each move. If you fail to 
respond in the allotted time, you forfeit your turn. 

If reversi is given a file name as an argument, it will checkpoint the game, move by move, by dumping the 
board onto file. The -r option will cause reversi to restart the game from file and continue logging. 

DIAGNOSTICS 

“Illegal!” for an illegal move, and “Huh?” for a move that even the machine cannot understand. 
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NAME 

sky - obtain ephemerides 

SYNOPSIS 

/usr/games/sky [ -I ] 

DESCRIPTION 

Sky predicts the apparent locations of the Sun, the Moon, the planets out to Saturn, stars of magnitude at 
least 2.5, and certain other celestial objects. Sky reads the standard input to obtain a GMT time typed on 
one line with blanks separating year, month number, day, hour, and minute; if the year is missing the cur¬ 
rent year is used. If a blank line is typed the current time is used. The program prints the azimuth, eleva¬ 
tion, and magnitude of objects which are above the horizon at the ephemeris location of Murray Hill at the 
indicated time. The -1 flag causes it to ask for another location. 

Placing a “1” input after the minute entry causes the program to print out the Greenwich Sidereal Time at 
the indicated moment and to print for each body its topographic right ascension and declination as well as 
its azimuth and elevation. Also, instead of the magnitude, the semidiameter of the body, in seconds of arc, 
is reported. 

A “2” after the minute entry makes the coordinate system geocentric. 

The effects of atmospheric extinction on magnitudes are not included; the brightest magnitudes of variable 
stars are marked with *. 

For all bodies, the program takes into account precession and nutation of the equinox, annual (but not diur¬ 
nal) aberration, diurnal parallax, and the proper motion of stars. In no case is refraction included. 

The program takes into account perturbations of the Earth due to the Moon, Venus, Mars, and Jupiter. The 
expected accuracies are: for the Sun and other stellar bodies a few tenths of seconds of arc; for the Moon 
(on which particular care is lavished) likewise a few tenths of seconds. For the Sun, Moon and stars the 
accuracy is sufficient to predict the circumstances of eclipses and occultations to within a few seconds of 
time. The planets may be off by several minutes of arc. 

There are lots of special options not described here, which do things like substituting named star catalogs, 
smoothing nutation and aberration to aid generation of mean places of stars, and making conventional 
adjustments to the Moon to improve eclipse predictions. 

For the most accurate use of the program it is necessary to know that it actually runs in Ephemeris time. 

FILES 

/usr/lib/startab, /usr/lib/moontab 
SEE ALSO 

American Ephemeris and Nautical Almanac, for the appropriate years; also, the Explanatory Supplement to 
the American Ephemeris and Nautical Almanac. 
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NAME 

ttt, cubic - tic-tac-toe 

SYNOPSIS 

/usr/games/ttt 

/usr/games/cubic 

DESCRIPTION 

Ttt is the X and O game popular in the first grade. This is a learning program that never makes the same 
mistake twice. 

Although it learns, it learns slowly. It must lose nearly 80 games to completely know the game. 

Cubic plays three-dimensional tic-tac-toe on a 4x4x4 board. Moves are specified as a sequence of three 
coordinate numbers in the range 1-4. 

FILES 

/usr/games/ttt.k learning file 
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NAME 

wump - the game of hunt-the-wumpus 

SYNOPSIS 

/usr/games/wump 

DESCRIPTION 

Wump plays the game of “Hunt the Wumpus.” A Wumpus is a creature that lives in a cave with several 
rooms connected by tunnels. You wander among the rooms, trying to shoot the Wumpus with an arrow, 
meanwhile avoiding being eaten by the Wumpus and falling into Bottomless Pits. There are also Super 
Bats which are likely to pick you up and drop you in some random room. 

The program asks various questions which you answer one per line; it will give a more detailed description 
if you want. 

This program is based on one described in People’s Computer Company, 2, 2 (November 1973). 

BUGS 

It will never replace Adventure. 
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NAME 

intro - introduction to miscellany 
DESCRIPTION 

This section describes miscellaneous facilities such as macro packages, character set tables, etc. 
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NAME 

ascii - map of ASCII character set 

SYNOPSIS 

cat /usr/pub/ascii 

DESCRIPTION 

Ascii is a map of the ASCII character set, giving both octal and hexadecimal equivalents of each character, 
to be printed as needed. It contains: 


000 

nu 1 

lOOl 

soh 

|002 

s tx 

|003 

etx 

|004 

eot 

|005 enq 

|006 

ack 

|007 

be 1 

010 

bs 

Ion 

ht 

|012 

nl 

|013 

vt 

|014 

np 

|015 cr 

|016 

so 

|017 

s i 

020 

die 

|021 

del 

|022 

dc2 

|023 

dc3 

|024 

dc4 

|025 nak 

|026 

syn 

|027 

e tb 

030 

can 

|031 

em 

|032 

sub 

|033 

esc 

|034 

f 

|035 gs 

|036 

r 

|037 

us 

040 

sp 

|041 

! 

|042 


|043 

# 

|044 

$ 

|045 % 

|046 

& 

|047 

- 

050 

( 

|051 

) 

|052 

* 

|053 

+ 

|054 

, 

|055 - 

|056 


|057 

/ 

060 

0 

|061 

1 

|062 

2 

|063 

3 

|064 

4 

|065 5 

|066 

6 

|067 

7 

070 

8 

|071 

9 

|072 


|073 


|074 

< 

|075 = 

|076 

> 

|077 

? 

100 

@ 

1 101 

A 

1 102 

B 

1 103 

C 

1 104 

D 

1 105 E 

1 106 

F 

1 107 

G 

110 

H 

1 111 

I 

1 112 

J 

1 113 

K 

1 114 

L 

1 115 M 

1 116 

N 

1 117 

0 

120 

P 

1 121 

Q 

1 122 

R 

1 123 

S 

1 124 

T 

1 125 U 

1 126 

V 

1 127 

W 

130 

X 

1 131 

Y 

1 132 

Z 

1 133 

[ 

1 134 

\ 

Il35 ] 

1 136 


1 137 


140 

- 

1 141 

a 

1 142 

b 

1 143 

c 

1 144 

d 

1 145 e 

1 146 

f 

1 147 

g 

150 

h 

1 151 

i 

1 152 

j 

1 153 

k 

1 154 

1 

1 155 m 

1 156 

n 

1 157 

o 

160 

P 

1 161 

q 

1 162 

r 

1 163 

s 

1 164 

t 

1 165 u 

1 166 

V 

1 167 

w 

170 

X 

1 171 

y 

1 172 

z 

1 173 

{ 

1 174 

1 

Il75 ) 

1 176 


1 177 

del 

00 

nu 1 

1 01 

soh 

1 02 

s tx 

1 03 

etx 

1 04 

eot 

1 05 enq 

1 06 

ack 

1 07 

be! 

08 

bs 

1 09 

ht 

1 Oa 

nl 

1 Ob 

vt 

1 Oc 

np 

1 Od cr 

1 Oe 

so 

1 Of 

s i 

10 

die 

1 11 

del 

1 12 

dc2 

1 13 

dc3 

1 14 

dc4 

1 15 nak 

1 16 

syn 

1 17 

e tb 

18 

can 

1 19 

em 

1 la 

sub 

1 lb 

esc 

1 Ic 

f 

1 Id gs 

1 le 

r 

1 If 

us 

20 

sp 

1 21 

! 

1 22 


1 23 

# 

1 24 

$ 

1 25 % 

1 26 

& 

1 27 

- 

28 

( 

1 29 

) 

1 2a 

=H 

1 2b 

+ 

1 2c 

, 

1 2d - 

1 2e 


1 2f 

/ 

30 

0 

1 31 

1 

1 32 

2 

1 33 

3 

1 34 

4 

1 35 5 

1 36 

6 

1 37 

7 

38 

8 

1 39 

9 

1 3a 


1 3b 


1 3c 

< 

1 3d = 

1 3e 

> 

1 3f 

? 

40 

@ 

1 41 

A 

1 42 

B 

1 43 

C 

1 44 

D 

1 45 E 

1 46 

F 

1 47 

G 

48 

H 

1 49 

I 

1 4a 

J 

1 4b 

K 

1 4c 

L 

1 4d M 

1 4e 

N 

1 4f 

0 

50 

P 

1 51 

Q 

1 52 

R 

1 53 

S 

1 54 

T 

1 55 U 

1 56 

V 

1 57 

W 

58 

X 

1 59 

Y 

1 5a 

Z 

1 5b 

[ 

1 5c 

\ 

1 5d ] 

1 5e 


1 5f 


60 

- 

1 61 

a 

1 62 

b 

1 63 

c 

1 64 

d 

1 65 e 

1 66 

f 

1 67 

g 

68 

h 

1 69 

i 

1 6a 

j 

1 6b 

k 

1 6c 

1 

1 6d m 

1 6e 

n 

1 6f 

o 

70 

P 

1 71 

q 

1 72 

r 

1 73 

s 

1 74 

t 

1 75 u 

1 76 

V 

1 77 

w 

78 

X 

1 79 

y 

1 7a 

z 

1 7b 

{ 

1 7c 

1 

1 7d ) 

1 7e 

' 

1 7f 

del 


FILES 


/usr/pub/ascii 
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NAME 

environ - user environment 
DESCRIPTION 

An array of strings called the “environment” is made available by exec(2) when a process begins. By con¬ 
vention, these strings have the form “name=value”. The following names are used by various commands: 

PATH The sequence of directory prefixes that .s/i(l), tifne(l), mce(l), nohup(l), etc., apply in searching 
for a file known by an incomplete path name. The prefixes are separated by colons (:). Login(l) 
sets PATH=:/bin:/usr/bin. 

HOME Name of the user’s login directory, set by logln(l) from the password file passwd(5). 

TERM The kind of terminal for which output is to be prepared. This information is used by commands, 
such as mm(l) or tplot(lG), which may exploit special capabilities of that terminal. 

TZ Time zone information. The format is xxxnzzz where xxx is standard local time zone abbreviation, 
n is the difference in hours from GMT, and zzz is the abbreviation for the daylight-saving local 
time zone, if any; for example, EST5EDT. 

Further names may be placed in the environment by the export command and “name=value” arguments in 

sh(l), or by exec(2). It is unwise to conflict with certain shell variables that are frequently exported by 

.profile files: MAIL, PSl, PS2, IFS. 

SEE ALSO 

env(l), login(l), sh(l), exec(2), getenv(3C), profile(5), term(7). 
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NAME 

eqnchar - special character definitions for eqn and neqn 
SYNOPSIS 

eqn /usr/pub/eqnchar [ files ] I troff [ options ] 
neqn /usr/pub/eqnchar [ files ] I nroff [ options ] 

DESCRIPTION 

Eqnchar contains trojf{\) and nroff{\.) character definitions for constructing characters that are not avail¬ 
able on the Wang Laboratories, Inc. C/A/T phototypesetter. These definitions are primarily intended for 
use with eqn{\) and neqn{\)-, eqnchar contains definitions for the following characters: 


ciplus 

© 

11 

II 

square 

□ 

citimes 

© 

langle 

/ 

\ 

circle 

o 

wig 

~ 

rangle 

\ 

/ 

blot 

□ 

-wig 

= 

hbar 

n 

bullet 

• 

>wig 

> 

ppd 

1 

prop 

oc 

<wig 

< 

<-> 

o 

empty 

0 

-wig 


<=> 


member 

€ 

star 


i< 

+ 

nomem 


bigstar 

* 

1 > 


cup 

U 

-dot 

= 

ang 

/ 

cap 

n 

orsign 

V 

rang 

L 

incl 

E 

andsign 

A 

3dot 


subset 

c 

-del 

A 

thf 


supset 

Z) 

oppA 


quarter 

'/4 

.'subset 

c 

oppE 

3 

Squarter 

% 

.'supset 

3 

angstrom 

A 

degree 





FILES 

/usr/pub/eqnchar 

SEE ALSO 

eqn(l), troff(l). 
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NAME 

fcntl - file control options 

SYNOPSIS 

#include <fcntl h> 

DESCRIPTION 

The fcntl(2) function provides for control over open files. This include file describes requests and 
arguments to fcntl -dnd open{2). 

/* Flag values accessible to open(2) and fcntl(2) */ 

/* (The first three can only be set by open) */ 

#define O RDONLY 0 
#define O WRONLY 1 
#define O RDWR 2 

#define O NDELAY 04 Non-blocking I/O 

#define 0_APPEND 010 /* append (writes guaranteed at the end) */ 


/* Elag values accessible only to open(2) */ 


#define 0_CREAT 00400 

#define O TRUNC 01000 

#define 0_EXCL 02000 

/* fcntl(2) requests */ 

#define F_DUPFD 0 

#define F_GETFD 1 

#define F_SETFD 2 

#define F_GETFL 3 

#define F_SETFL 4 

SEE ALSO 

fcntl(2), open(2). 


/* open with file create (uses third open arg)*/ 
/* open with truncation */ 

/* exclusive open */ 

/* Duplicate hides */ 

/* Get hides hags */ 

/* Set hides hags */ 

/* Get hie hags 
/* Set hie hags */ 
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NAME 

greek - graphics for the extended TTY-37 type-box 
SYNOPSIS 

cat /usr/pub/greek [ I greek -Tterminal ] 

DESCRIPTION 

Greek gives the mapping from ASCII to the “shift-out” graphics in effect between SO and SI on 
TELETYPE.nh 

Model 37 terminals equipped with a 128-character type-box. These are the default greek characters pro¬ 
duced by nrojf{V). The filters of greek{\) attempt to print them on various other terminals. The file con¬ 
tains: 


alpha 

a 

A 

beta 

p 

B 

gamma 

Y 

\ 

GAMMA 

r 

G 

delta 

5 

D 

DELTA 

A 

W 

epsilon 

8 

s 

zeta 

C 

Q 

eta 

n 

N 

THETA 

© 

T 

theta 

0 

o 

lambda 

X 

L 

LAMBDA 

A 

E 

mu 


M 

nu 

V 

@ 

xi 


X 

pi 

n 

J 

PI 

n 

P 

rho 

P 

K 

sigma 

a 

Y 

SIGMA 

I 

R 

tau 

X 

I 

phi 


U 

PHI 


E 

psi 


V 

PSI 


H 

omega 

CO 

C 

OMEGA 

a 

z 

nabla 

V 

[ 

not 

—1 


partial 

a 

] 

integral 

J 






EILES 

/usr/pub/greek 
SEE ALSO 

300(1), 4014(1), 450(1), greek(l), hp(l), tc(l), troff(l). 
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NAME 

man - macros for formatting entries in this manual 

SYNOPSIS 

nroff -man files 

troff -man [ -rsl ] files 
DESCRIPTION 

These trojf{l) macros are used to lay out the format of the entries of this manual. A skeleton entry may be 
found in the file /usr/man/manO/skeleton. These macros are used by the man{\) command. 

The default page size is 8.5"xll", with a 6.5"xl0" text area; the -rsl option reduces these dimensions to 
6"x9" and 4.75"x8.375", respectively; this option (which is not effective in nroff{\.)) also reduces the 
default type size from 10-point to 9-point, and the vertical line spacing from 12-point to 10-point. The 
-rV2 option may be used to set certain parameters to values appropriate for certain Versatec printers: it sets 
the line length to 82 characters, the page length to 84 lines, and it inhibits underlining; this option should 
not be confused with the -Tvp option of the man{\) command, which is available at some UNIX sites. 

Any text argument below may be one to six “words”. Double quotes ("") may be used to include blanks 
in a “word”. If text is empty, the special treatment is applied to the next line that contains text to be 
printed. For example, .1 may be used to italicize a whole line, or .SM followed by .B to make small bold 
text. By default, hyphenation is turned off for nroff, but remains on for troff. 

Type font and size are reset to default values before each paragraph and after processing font- and size¬ 
setting macros, e.g., .1, .RB, .SM. Tab stops are neither used nor set by any macro except .DT and .TH. 

Default units for indents in are ens. When in is omitted, the previous indent is used. This remembered 
indent is set to its default value (7.2 ens in troff, 5 ens in nroff-\h\^ corresponds to 0.5" in the default page 
size) by .TH, .PP, and .RS, and restored by .RE. 

.TH t s c n Set the title and entry heading; t is the title, s is the section number, c is extra commentary, e.g., 
“local”, n is new manual name. Invokes .DT (see below). 

.SH text Place subhead text, e.g., SYNOPSIS, here. 

.SS text Place sub-subhead text, e.g., Options, here. 

.B text Make text bold. 

.1 text Make text italic. 

.SM text Make text 1 point smaller than default point size. 

.RI a b Concatenate roman a with italic b, and alternate these two fonts for up to six arguments. Simi¬ 
lar macros alternate between any two of roman, italic, and bold: 

.IR .RB .BR .IB .BI 

.P Begin a paragraph with normal font, point size, and indent. .PP is a synonym for .P. 

.HP in Begin paragraph with hanging indent. 

.TP in Begin indented paragraph with hanging tag. The next line that contains text to be printed is 
taken as the tag. If the tag does not fit, it is printed on a separate line. 

.IP t in Same as .TP in with tag r; often used to get an indented paragraph without a tag. 

.RS in Increase relative indent (initially zero). Indent all output an extra in units from the current left 

margin. 

.RE k Return to the ^th relative indent level (initially, k=l-, k-0 is equivalent to k-l); if k is omitted, 
return to the most recent lower indent level. 

.PM m Produces proprietary markings; where m may be P for PRIVATE, N for NOTICE, BP for BELL 
LABORATORIES PROPRIETARY, or BR for BELL LABORATORIES RESTRICTED. 

.DT Restore default tab settings (every 7.2 ens in troff, 5 ens in nroff). 

.PD V Set the interparagraph distance to v vertical spaces. If v is omitted, set the interparagraph dis¬ 

tance to the default value (0.4v in troff, Iv in nroff). 

The following strings are defined: 
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\*R ® in (Reg.) in nrqff(l). 

\*S Change to default type size. 

The following number registers are given default values by .TH: 

IN Left margin indent relative to subheads (default is 7.2 ens in trojf, 5 ens in nrojf). 

LL Line length including IN. 

PD Current interparagraph distance. 

CAVEATS 

In addition to the macros, strings, and number registers mentioned above, there are defined a number of 
internal macros, strings, and number registers. Except for names predefined by trojf{l) and number regis¬ 
ters d, m, and y, all such internal names are of the form X4, where X is one of), ], and }, and A stands for 
any alphanumeric character. 

If a manual entry needs to be preprocessed by cw(l), eqn{\) (or neqn), and/or tbl{l), it must begin with a 
special line (described in man{\.)), causing the man command to invoke the appropriate preprocessor(s). 

The programs that prepare the Table of Contents and the Permuted Index for this Manual assume the NAME 
section of each entry consists of a single line of input that has the following format: 

name[, name, name ...] \- explanatory text 

The macro package increases the inter-word spaces (to eliminate ambiguity) in the SYNOPSIS section of 
each entry. 

The macro package itself uses only the roman font (so that one can replace, for example, the bold font by 
the constant-width font-see cw(l)). Of course, if the input text of an entry contains requests for other fonts 
(e.g., .1, .RB, \fl), the corresponding fonts must be mounted. 

FILES 

/usr/lib/tmac/tmac.an 

/usr/lib/macros/cmp.[nt].[dt].an 

/usr/lib/macros/ucmp.[nt].an 

/usr/man/manO/skeleton 

SEE ALSO 

man(l), troff(l). 

BUGS 

If the argument to .TH contains any blanks and is not enclosed by double quotes (""), there will be bird- 
dropping-like things on the output. 
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NAME 

mm - the MM macro package for formatting documents 
SYNOPSIS 

mm [ options ] [ files ] 
nroff -mm [ options ] [ files ] 
nroff -cm [ options ] [ files ] 


mmt [ options ] [ files ] 
troff -mm [ options ] [ files ] 
troff -cm [ options ] [ files ] 


DESCRIPTION 

This package provides a formatting capability for a very wide variety of documents. It is the standard pack¬ 
age used by the BTL typing pools and documentation centers. The manner in which a document is typed in 
and edited is essentially independent of whether the document is to be eventually formatted at a terminal or 
is to be phototypeset. See the references below for further details. 

The -mm option causes nrqff(l) and trqff(\) to use the non-compacted version of the macro package, while 
the -cm option results in the use of the compacted version, thus speeding up the process of loading the 
macro package. 


FILES 

/usr/lib/tmac/tmac m 
/usr/lib/macros/mm[nt] 
/usr/lib/macros/cmp.[nt].[dt] m 
/usr/lib/macros/ucmp.[nt] m 


pointer to the non-compacted version of the package 
non-compacted version of the package 
compacted version of the package 
initializers for the compacted version of the package 


SEE ALSO 

mm(l), mmt(l), troff(l). 

MM-Memorandum Macros by D. W. Smith and J. R. Mashey. 
Typing Documents with MM by D. W. Smith and E. M. Piskorik. 
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NAME 

mv - a macro package for making view graphs 
SYNOPSIS 

mvt [ options ] [ files ] 
troff -mv [ options ] [ files ] 

DESCRIPTION 

This package provides an easy-to-use facility for making view graphs and projection slides in a variety of 
formats. A dozen or so macros are provided that accomplish most of the formatting tasks needed in making 
transparencies. All of the facilities of trojf{\), eqn{\), and tbl{\) are available for more difficult tasks. The 
output can be previewed on most terminals, and, in particular, on the Tektronix 4014 and on the Versatec 
printer. See the reference below for further details. 

FILES 

/usr/lib/tmac/tmac.v 
SEE ALSO 

eqn(l), mvt(l), tbl(l), troff(l). 

A Macro Package for View Graphs and Slides by T. A. Dolotta and D. W. Smith (in preparation). 
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NAME 

regexp - regular expression compile and match routines 
SYNOPSIS 

#define INIT <declarations> 

#define GETC() <getc code> 

#define PEEKC() <peekc code> 

#define UNGETC(c) <ungetc code> 

#define RETURN(pointer) <return code> 

#define ERROR(val) <error code> 

#include <regexp.h> 

char *compile(instrmg, expbuf, endbuf, eof) 
char *instring, *expbuf, *endbuf; 

int step(string, expbuf) 
char ^string, *expbuf; 

DESCRIPTION 

This page describes general purpose regular expression matching routines in the form of ed{\.), defined in 
/usr/include/regexp.h. Programs such as ed{\), sed{V), grep{l), ^^(1), expr{l), etc., which perform regu¬ 
lar expression matching use this source file. In this way, only this file need be changed to maintain regular 
expression compatibility. 

The interface to this file is unpleasantly complex. Programs that include this file must have the following 
five macros declared before the “#include <regexp h>” statement. These macros are used by the compile 
routine. 


GETCO 
PEEKC() 


UNGETC(c) 


RETURN(pomfer) 


ERROR(ya/) 


Return the value of the next character in the regular expression pattern. Succes¬ 
sive calls to GETC() should return successive characters of the regular expression. 

Return the next character in the regular expression. Successive calls to PEEKC() 
should return the same character (which should also be the next character returned 
by GETC()). 

Cause the argument c to be returned by the next call to GETC() (and PEEKC()). 
No more that one character of pushback is ever needed and this character is guar¬ 
anteed to be the last character read by GETC(). The value of the macro 
UNGETC(c) is always ignored. 

This macro is used on normal exit of the compile routine. The value of the argu¬ 
ment pointer is a pointer to the character after the last character of the compiled 
regular expression. This is useful to programs which have memory allocation to 
manage. 

This is the abnormal return from the compile routine. The argument val is an 
error number (see table below for meanings). This call should never return. 
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ERROR MEANING 

11 Range endpoint too large. 

16 Bad number. 

25 ‘ ‘\digit’ ’ out of range. 

36 Illegal or missing delimiter. 

41 No remembered search string. 

42 \( \) imbalance. 

43 Too many \(. 

44 More than 2 numbers given in \{ \}. 

45 } expected after \. 

46 First number exceeds second in \{ \}. 

49 [ ] imbalance. 

50 Regular expression overflow. 

The syntax of the compile routine is as follows: 
compiIe(instring, expbuf, endbuf, eof) 

The first parameter instring is never used explicitly by the compile routine but is useful for programs that 
pass down different pointers to input characters. It is sometimes used in the INIT declaration (see below). 
Programs which call functions to input characters or have characters in an external array can pass down a 
value of ((char *) 0) for this parameter. 

The next parameter expbuf is a character pointer. It points to the place where the compiled regular expres¬ 
sion will be placed. 

The parameter endbuf is one more that the highest address that the compiled regular expression may be 
placed. If the compiled expression cannot fit in (endbuf-expbuf) bytes, a call to ERROR(50) is made. 

The parameter eof is the character which marks the end of the regular expression. For example, in ed(l), 
this character is usually a /. 

Each programs that includes this file must have a #define statement for INIT. This definition will be placed 
right after the declaration for the function compile and the opening curly brace ({). It is used for dependent 
declarations and initializations. Most often it is used to set a register variable to point the beginning of the 
regular expression so that this register variable can be used in the declarations for GETC(), PEEKC() and 
UNGETC(). Otherwise it can be used to declare external variables that might be used by GETC(), PEEKC() 
and UNGETC(). See the example below of the declarations taken from grep{l). 

There are other functions in this file which perform actual regular expression matching, one of which is the 
function step. The call to step is as follows: 

step(string, expbuf) 

The first parameter to step is a pointer to a string of characters to be checked for a match. This string 
should be null terminated. 

The second parameter expbuf is the compiled regular expression which was obtained by a call of the func¬ 
tion compile. 

The function step returns one, if the given string matches the regular expression, and zero if the expressions 
do not match. If there is a match, two external character pointers are set as a side effect to the call to step. 
The variable set in .step is loci. This is a pointer to the first character that matched the regular expression. 
The variable loc2, which is set by the function advance, points the character after the last character that 
matches the regular expression. Thus if the regular expression matches the entire line, loci will point to the 
first character of string and loc2 will point to the null at the end of string. 

Step uses the external variable circf which is set by compile if the regular expression begins with If this 
is set then step will only try to match the regular expression to the beginning of the string. If more than one 
regular expression is to be compiled before the the first is executed the value of circf should be saved for 
each compiled expression and circf should be set to that saved value before each call to step. 
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The function advance is called from step with the same arguments as step. The purpose of step is to step 
through the string argument and call advance until advance returns a one indicating a match or until the 
end of string is reached. If one wants to constrain string to the beginning of the line in all cases, step need 
not be called, simply call advance. 

When advance encounters a * or \{ \} sequence in the regular expression it will advance its pointer to the 
string to be matched as far as possible and will recursively call itself trying to match the rest of the string to 
the rest of the regular expression. As long as there is no match, advance will back up along the string until 
it finds a match or reaches the point in the string that initially matched the * or \{ \}. It is sometimes desir¬ 
able to stop this backing up before the initial point in the string is reached. If the external character pointer 
Iocs is equal to the point in the string at sometime during the backing up process, advance will break out of 
the loop that backs up and will return zero. This is used be ed{\) and sed{\.) for substitutions done globally 
(not just the first occurrence, but the whole line) so, for example, expressions like s/y*//g do not loop for¬ 
ever. 


The routines ecmp and getrange are trivial and are called by the routines previously mentioned. 


EXAMPLES 

The following is an example of how the regular expression macros and calls look from grep (1): 


#define INIT 
#define GETC() 
#define PEEKC() 
#define UNGETC(c) 
#define RETURN(c) 
#define ERROR(c) 

#include <regexp h> 


register char *sp = instring; 
(*sp+-i-) 

(*sp) 

(—sp) 
return; 
regerrO 


compile(*argv, expbuf, &expbuf[ESIZE], '\0'); 


if(step(linebuf, expbuf)) 

succeedO; 

FILES 

/usr/include/regexp.h 
SEE ALSO 

ed(l), grep(l), sed(l). 

BUGS 

The handling of circf is kludgy. 

The routine ecmp is equivalent to the Standard I/O routine strncmp and should be replaced by that routine. 
The actual code is probably easier to understand than this manual page. 



STAT(7) 


STAT(7) 


NAME 

stat - data returned by stat system call 
SYNOPSIS 

#include <sys/types h> 

#mclude <sys/stat.h> 

DESCRIPTION 

The system calls stat and fstat(2) return data whose structure is defined by this include file. The encoding 
of the field stjnode is defined in this file also. 

/* 

* Structure of the result of stat 
*/ 


struct 

r 

stat 




i 

dev t 

St dev; 




ino t 

st ino; 




ushort 

St mode; 




short 

St nlink; 




ushort 

St uid; 




ushort 

St gid; 




dev t 

St rdev; 




offt 

St size; 




time t 

St atime; 




time t 

St mtime; 



}; 

time t 

St ctime; 



#define 

S_IFMT 

0170000 


/* type of file */ 

#define 


S IFDIR 

0040000 

/* directory */ 

#define 


S IFCHR 

0020000 

/* character special */ 

#define 


S IFBLK 

0060000 

/* block special */ 

#define 


S IFREG 

0100000 

/* regular */ 

#define 


S IFIFO 

0010000 

/* fifo */ 

#define 

S ISUID 

04000 


/* set user id on execution */ 

#define 

S ISGID 

02000 


/* set group id on execution */ 

#define 

S ISVTX 

01000 


/* save swapped text even after use */ 

#define 

S IREAD 

00400 


/* read permission, owner */ 

#define 

S IWRITE 

00200 


/* write permission, owner */ 

#define 

S lEXEC 

00100 


/* execute/search permission, owner */ 


FILES 

/usr/include/sys/types h 
/usr/include/sys/stat.h 

SEE ALSO 

stat(2). 
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NAME 

term - conventional names 
DESCRIPTION 

These names are used by certain commands (e.g., nrojf{V), mm(l), maniX), tabs{\)) and are maintained as 
part of the shell environment (see sh(\), profile(5), and environil)) in the variable $TERM: 

1520 Datamedia 1520 

1620 Diablo 1620 and others using the HyType II printer 

1620-12 same, in 12-pitch mode 

2621 Hewlett-Packard HP2621 series 

2631 Hewlett-Packard 2631 line printer 

2631-c Hewlett-Packard 2631 line printer - compressed mode 

2631-e Hewlett-Packard 2631 line printer - expanded mode 

2640 Hewlett-Packard HP2640 series 

2645 Hewlett-Packard HP264n series (other than the 2640 series) 

300 DASI/DTC/GSI 300 and others using the HyType I printer 

300-12 same, in 12-pitch mode 

300s DASI/DTC/GSI 300s 

382 DTC 382 

300s-12 same, in 12-pitch mode 

3045 Datamedia 3045 

33 TELETYPE nh 

Model 33 KSR 

37 TELETYPE Model 37 KSR 
40-2 TELETYPE Model 40/2 
4000A Trendata 4000A 

4014 Tektronix 4014 

43 TELETYPE Model 43 KSR 
450 DASI 450 (same as Diablo 1620) 

450-12 same, in 12-pitch mode 
735 Texas Instruments TI735 and TI725 

745 Texas Instruments TI745 

dumb generic name for terminals that lack reverse 
line-feed and other special escape sequences 
hp Hewlett-Packard (same as 2645) 

Ip generic name for a line printer 

tnl200 General Electric TermiNet 1200 

tn300 General Electric TermiNet 300 

Up to 8 characters, chosen from [-a-zO-9], make up a basic terminal name. Terminal sub-models and 
operational modes are distinguished by suffixes beginning with a Names should generally be based on 
original vendors, rather than local distributors. A terminal acquired from one vendor should not have more 
than one distinct basic name. 

Commands whose behavior depends on the type of terminal should accept arguments of the form -Tterm 
where term is one of the names given above; if no such argument is present, such commands should obtain 
the terminal type from the environment variable $TERM, which, in turn, should contain term. 

SEE ALSO 

mm(l), nroff(l), tplot(lG), sh(l), stty(l), tabs(l), profile(5), environ(7). 


BUGS 


This is a small candle trying to illuminate a large, dark problem. Programs that ought to adhere to this 
nomenclature do so somewhat fitfully. 
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NAME 

types “ primitive system data types 
SYNOPSIS 

#mclude <sys/types h> 

DESCRIPTION 

The data types defined in the include file are used in UNIX system code; some data of these types are acces¬ 
sible to user code: 

typedef struct { intr[l]; } * physadr; 

typedef long daddr_t; 

typedef char * caddr_t; 

typedef unsigned short ushort; 
typedef ushort ino_t; 

#ifdef vax 

typedef short cnt_t; 

#else 

typedef char cnt_t; 

#endif 

typedef long time_t; 

#ifdef vax 

typedef int label_t[10]; 

#else 

typedef int label_t[6]; 

#endif 

typedef short dev_t; 

typedef long off_t; 

typedef long paddr_t; 

The form daddrj is used for disk addresses except in an i-node on disk, see/?(5). Times are encoded in 
seconds since 00:00:00 GMT, January 1, 1970. The major and minor parts of a device code specify kind 
and unit number of a device and are installation-dependent. Offsets are measured in bytes from the begin¬ 
ning of a file. The labelj variables are used to save the processor state while another process is running. 

SEE ALSO 

fs(5). 
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NAME 

intro - introduction to system maintenance procedures 
DESCRIPTION 

This section outlines certain procedures that will be of interest to those charged with the task of system 
maintenance. Included are discussions on such topics as boot procedures, recovery from crashes, file back¬ 
ups, etc. 

BUGS 

No manual can take the place of good, solid experience. 
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NAME 

70boot - 11/70 bootstrap procedures 
DESCRIPTION 

To bootstrap programs from a wide range of storage media, the PDP-11/70 has a dedicated diagnostic boot¬ 
strap loader called the M9301-YC. The M9301-YC contains two 256 word ROMs (17 765 000 to 
17 765 776 and 17 773 000 to 17 773 776) which contain hardware verification diagnostic routines and 
bootstrap loader routines. 

The diagnostic portion tests the basic CPU to verify correct operation. The branches, registers, all address¬ 
ing modes, and most of the instructions are checked. If requested, memory management and the UNIBUS 
map are turned on. Then memory is tested from virtual address 001 000 to 157 776 with the cache dis¬ 
abled. Next the cache is enabled and tested. 

The physical memory tested is determined by the console switches. Console switches <15:12> are used to 
set physical address bits <19:16>. If console switches <15:12> are zero, memory management and the 
UNIBUS map will not be enabled, so that physical memory 0 to 157 776 will be used. If console switches 
<15:12> are non-zero, then memory management, the UNIBUS map, and 22-bit mapping will be enabled. 
Table I describes the physical address ranges for each switch setting. In all cases, virtual addresses 160 000 
to 177 776 are mapped to the peripheral page, physical addresses 17 600 000 to 17 777 776. Note that 
physical memory above 512K words is not accessible by this program even though the physical memory 
maximum is 1920K words. 

The bootstrap portion of the M9301-YC attempts to BOOT from the device and drive number specified in 
the console switches. Console switches <7:3> select the device and console switches <2:0> select the drive 
number. Table II describes the devices selected for each switch setting. If console switches <7:0> are zero, 
the program will read a set of switches on the M9301-YC, set by field service, to determine a default boot 
device and drive number. These switches appear at location 17 773 024, however bits <8:4> select the 
device and bits <3;1> select the drive number. 

Having selected a boot device, the program will read a block of data into memory starting at virtual address 
0, and then jump to virtual address 0. Table III describes the details of booting for each device. Note that 
the physical address selection is the same as described above for the diagnostic portion. Excluding the 
RXl 1/RXOl floppy disk, bootstrap programs must fit in one block of 256 words, even though this program 
may read in more. 

To start operation of the bootstrap loader, halt the CPU by depressing the HALT switch, set the Address Dis¬ 
play select switch to Console Physical, set the Console Switch Register to 165 000, and depress the Load 
Address switch. Then reset the console switches to 0 and set switches <15:12> for the desired physical 
memory (normally 0) and switches <7:0> for the desired device (normally 0 for the default boot). Put the 
HALT switch in the ENABLE position and depress the START switch. The diagnostic portion will then run 
followed by the boot from the selected media. This takes approximately three seconds. 

Any error during the diagnostic portion will cause the CPU to halt. Table IV lists the addresses and error 
indications. Only cache errors are recoverable in that by pressing the CONTINUE switch the program will 
disable the cache by forcing misses and proceed to the bootstrap section. If there is an error in reading the 
boot block, the program will do a RESET instruction and jump back to the memory test section (test 24) and 
then attempt to boot again. 

SEE ALSO 

romboot(8), unixboot(8). 
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Table I - Physical Memory Selection 


Console switches <15:12> Physical addresses 


00 

00 000 000 - 

00 157 776 

01 

00 200 000 - 

00 357 776 

02 

00 400 000 - 

00 557 776 

03 

00 600 000 - 

00 757 776 

04 

01 000 000- 

01 157 776 

05 

01 200 000- 

01 357 776 

06 

01 400 000- 

01 557 776 

07 

01 600 000- 

01 757 776 

10 

02 000 000 - 

02 157 776 

11 

02 200 000 - 

02 357 776 

12 

02 400 000 - 

02 557 776 

13 

02 600 000 - 

02 757 776 

14 

03 000 000 - 

03 157 776 

15 

03 200 000 - 

03 357 776 

16 

03 400 000 - 

03 557 776 

17 

03 600 000 - 

03 757 776 


Table II - Device selection 


Console switches <7:3> 

Device 


00 

illegal 


01 

TMll/TUlO 

Magnetic tape 

02 

TC11/TU56 

DECtape 

03 

RKl 1/RK05 

Disk pack 

04 

RP11/RP03 

Disk pack 

05 

reserved 


06 

RH70/TU16 

Magnetic tape 

07 

RH70/RP04 

Disk pack 

10 

RH70/RS04 

Fixed head disk 

11 

RXll/RXOl 

Diskette 

12-37 

illegal 
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TUIO: 


TU56: 
RK05 or 
RP03: 
TU16: 


RP04: 


RS04: 

RXOl: 


Table III - Boot procedures 

Select drive, wait until online, 

set to 800 bpi, rewind, 

space forward 1 record, 

read 1 record (maximum of 256 words). 

Select drive, rewind, read 512 words. 

Select drive, start at block 0, read 512 words. 

Select drive on first TM02, wait until online, 

set to 800 bpi, PDP format, rewind, 

space forward 1 record, 

read 1 record (maximum of 512 words). 

Select drive, read-in preset, 

set to 16-bits/word, ECC inhibit, 

start at block 0, read 512 words. 

Select drive, start at block 0, read 512 words. 
Select drive 0 or 1, 

start at track 1, sector 1 (IBM standard), 
read 64 words. 
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Table IV - Error halts 


Address displayed Test 


17 765 004 

1 

17 765 020 

2 

17 765 036 

3 

17 765 052 

4 

17 765 066 

5 

17 765 076 

6 

17 765 134 

7 

17 765 146 

10 

17 765 166 

11 

17 765 204 

12 

17 765 214 

13 

17 765 222 

14 

17 765 236 

14 

17 765 260 

15 

17 765 270 

16 

17 765 312 

16 

17 765 346 

17 

17 765 360 

20 

17 765 374 

20 

17 765 450 

21 

17 765 474 

22 

17 765 510 

23 

17 765 520 

23 

17 765 530 

23 

17 765 542 

23 

17 765 550 

23 

17 765 742 

25 

17 765 760 

25 

17 776 000 

25 

17 773 644 

26 

17 773 654 

26 

17 773 736 

27 

17 773 746 

27 

17 773 764 

25/26 


Subsystem under test 

Branch 

Branch 

Branch 

Branch 

Branch 

Branch 

Register data path 
Branch 

CPU instruction 
CPU instruction 
CPU instruction 
CPU instruction 
CPU instruction 
CPU instruction 
Branch 

CPU instruction 

CPU instruction 

CPU instruction 

CPU instruction 

Kernel PAR 

Kernel PDR 

JSR 

JSR 

RTS 

RTI 

IMP 

Main memory data compare error 
Main memory data compare error 
Main memory parity error; 

no recovery possible from this error 
Cache memory data compare error 
Cache memory no hit, recoverable 
Cache memory data compare error 
Cache memory no hit, recoverable 
Cache memory parity error, recoverable 



CRASH(8) 


CRASH(8) 


NAME 

crash - what to do when the system crashes 
DESCRIPTION 

This entry gives at least a few clues about how to proceed if the system crashes. It can’t pretend to be com¬ 
plete. 

How to bring it back up. If the reason for the crash is not evident (see below for guidance on “evident”) 
you may want to try to dump the system if you feel up to debugging. At the moment a dump can be taken 
only on magtape. With a tape mounted and ready, stop the machine, load address 44(8) (on the PDP-11), 
400(16) (on the VAX-11/780; see vaxopsi^,)), and start. This should write a copy of all of core on the tape 
with an EOF mark. Be sure the ring is in, the tape is ready, and the tape is clean and new. 

In restarting after a crash, always bring up the system single-user, as specified in unixboot{%) as modified 
for your particular installation. Then perform an/5c^(lM) on all file systems which could have been in use 
at the time of the crash. If any serious file system problems are found, they should be repaired. When you 
are satisfied with the health of your disks, check and set the date if necessary, then come up multi-user. 

To even boot UNIX at all, three files (and the directories leading to them) must be intact. First, the initial¬ 
ization program /etc/init must be present and executable. If it is not, the CPU will loop in user mode at 
location 6(8) (PDP-11), 13(16) (VAX-11/780). For init to work correctly, /dev/console and /bin/sh must be 
present. If either does not exist, the symptom is best described as thrashing. Init will go into a fork/exec 
loop trying to create a Shell with proper standard input and output. 

If you cannot get the system to boot, a runnable system must be obtained from a backup medium. The root 
file system may then be doctored as a mounted file system as described below. If there are any problems 
with the root file system, it is probably prudent to go to a backup system to avoid working on a mounted 
file system. 

Repairing disks. The first rule to keep in mind is that an addled disk should be treated gently; it shouldn’t 
be mounted unless necessary, and if it is very valuable yet in quite bad shape, perhaps it should be copied 
before trying surgery on it. This is an area where experience and informed courage count for much. 

Fsck(\M) is adept at diagnosing and repairing file system problems. It first identifies all of the files that 
contain bad (out of range) blocks or blocks that appear in more than one file. Any such files are then 
identified by name and fsck requests permission to remove them from the file system. Files with bad blocks 
should be removed. In the case of duplicate blocks, all of the files except the most recently modified should 
be removed. The contents of the survivor should be checked after the file system is repaired to ensure that it 
contains the proper data. (Note that running fsck with the -n option will cause it to report all problems 
without attempting any repair.) 

Fsck will also report on incorrect link counts and will request permission to adjust any that are erroneous. 
In addition, it will reconnect any files or directories that are allocated but have no file system references to a 
“lost+found” directory. Finally, if the free list is bad (out of range, missing, or duplicate blocks) fsck will, 
with the operators concurrence, construct a new one. 

Why did it crashi UNIX types a message on the console typewriter when it voluntarily crashes. Here is the 
current list of such messages, with enough information to provide a hope at least of the remedy. The mes¬ 
sage has the form “panic: ...”, possibly accompanied by other information. Left unstated in all cases is 
the possibility that hardware or software error produced the message in some unexpected way. 

blkdev 

The getblk routine was called with a nonexistent major device as argument. Definitely hardware or 
software error. 

devtab 

Null device table entry for the major device used as argument to getblk. Definitely hardware or soft¬ 
ware error. 

iinit An I/O error reading the super-block for the root file system during initialization. 
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no fs A device has disappeared from the mounted-device table. Definitely hardware or software error, 
no imt 

Like “no fs”, but produced elsewhere, 
no clock 

During initialization, neither the line nor programmable clock was found to exist. 

I/O error in swap 

An unrecoverable I/O error during a swap. Really shouldn’t be a panic, but it is hard to fix. 
out of swap space 

A program needs to be swapped out, and there is no more swap space. It has to be increased. This 
really shouldn’t be a panic, but there is no easy fix. 

trap An unexpected trap has occurred within the system. This is accompanied by three numbers: a 
“ka6’’, which is the contents of the segmentation register for the area in which the system’s stack is 
kept; “aps”, which is the location where the hardware stored the program status word during the 
trap; and a “trap type’’ which encodes which trap occurred. The trap types are: 

PDP-11: 

0 bus error 

1 illegal instruction 

2 BPT/trace 

3 lOT 

4 power fail 

5 EMT 

6 recursive system call (TRAP instruction) 

7 11/70 cache parity, or programmed interrupt 

8 floating point trap 

9 segmentation violation 

VAX-11/780: 

0 reserved addressing fault 

1 illegal instruction 

2 BPT instruction trap 

3 XFC instruction trap 

4 reserved operand fault 

5 recursive system call (CHMK instruction) 

6 floating point trap 

7 software level 1 (reschedule) trap 

8 segmentation violation 

9 protection fault 

10 trace trap 

11 compatibility mode fault 

In some of these cases it is possible for octal 40 to be added into the trap type; this indicates that the proces¬ 
sor was in user mode when the trap occurred. If you wish to examine the stack after such a trap, either 
dump the system, or use the console switches to examine core; the required address mapping is described 
below. 

Interpreting dumps. All file system problems should be taken care of before attempting to look at dumps. 
The dump should be read into the file /usr/tmp/core; cp(\) will do. At this point, you should execute ps 
-el -c /usr/tmp/core and who to print the process table and the users who were on at the time of the crash. 
Additional information for the PDP-11. You should dump (adh(l)) the first 30 bytes of /usr/tmp/core. 
Starting at location 4, the registers RO, Rl, R2, R3, R4, R5, SP and KDSA6 (KISA6 for ll/40s) are stored. If 
the dump had to be restarted, RO will not be correct. Next, take the value of KA6 (location 22(8) in the 
dump) multiplied by 100(8) and dump 2000(8) bytes starting from there. This is the per-process data asso¬ 
ciated with the process running at the time of the crash. Relabel the addresses 140000 to 141776. R5 is C’s 
frame or display pointer. Stored at (R5) is the old R5 pointing to the previous stack frame. At (R5)+2 is the 
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saved PC of the calling procedure. Trace this calling chain until you obtain an R5 value of 141756, which is 
where the user’s R5 is stored. If the chain is broken, you have to look for a plausible R5, PC pair and con¬ 
tinue from there. Each PC should be looked up in the system’s name list using adb{\.) and its : command, 
to get a reverse calling order. In most cases this procedure will give an idea of what is wrong. A more 
complete discussion of system debugging is impossible. 

SEE ALSO 

adb(l), fsck(lM), unixboot(8), vaxops(8). 
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NAME 

diskboot - disk bootstrap programs 
DESCRIPTION 

There are several programs available to accomplish bootstraps off of a variety of disks. These programs 
reside in the directory /stand. 

The program must be located in block 0 of the disk pack. The space available for the program is thus only 
one block (256 words) which severely constrains the amount of error handling. Block 0 is unused by the 
UNIX file system, so this does not affect normal file system operation. To boot, the program must be read 
into memory starting at address 0 and started at address 0. This may be accomplished by standard DEC 
ROM bootstraps, special ROM bootstraps, or manual procedures. 

After initial load, the program relocates itself to high core as specified when assembled (typically 24K 
words, maximum of 28K). Next, memory below the program is cleared and the prompt # is typed on the 
console. A one digit field specifying the disk drive is expected. For example, 2 would correspond to drive 
2, starting at cylinder 0. The last word in the boot block contains a cylinder offset, initially zero, which 
may be changed to access another section of the disk pack. No error checking is done on this field; invalid 
data will cause unpredictable results. Also, there is no error checking on disk reads. 

After the file system select, the program prompts with =. The user must then enter the UNIX path name of 
the desired file. The # character will erase the last character typed, the @ character will kill the entire line, 
and A through Z is translated to a through z. Also, carriage return (CR) is mapped into line-feed (LF) on 
input, and LF is output as CR-LF. The upper-case to lower-case conversion is used to handle upper-case- 
only terminals such as the TELETYPE nh 

Model 33 or the DEC LA30. Therefore, a file name with upper case characters cannot be booted using this 
procedure. 

After the name has been completely entered by typing CR or LF, the program searches the file system 
specified for the path name. Note, the path name may be any valid UNIX file system path name. If the file 
does not exist, or if the file is a directory or special file, the bootstrap starts over and prompts with #. Other¬ 
wise, the file is read into memory starting at address 0. If address 0 contains 000 407, a UNIX a.out pro¬ 
gram is assumed and the first 8 words are stripped off by relocating the loaded program toward address 0. 
Finally, a jump to address 0 is done by executing jsr pc,*$0. 

FILES 

/usr/src/stand source directory 
SEE ALSO 

a.out(5), fs(5), tapeboot(8), unixboot(8). 
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NAME 

etp - Equipment Test Package 
DESCRIPTION 

Etp is a stand-alone program that exercises the PDP-11 or VAX-11/780 hardware in a manner that simulates 
the load imposed by a UNIX system. Its output consists of reports that can be formatted to resemble the 
output of DEC diagnostic programs. 

SEE ALSO 

errpt(lM). 

The UNIX Equipment Test Package: Operational Procedures by A. L. Chellis and T. J. Kowalski. 
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NAME 

filesave, tapesave - daily/weekly UNIX file system backup 

SYNOPSIS 

/etc/filesave.? 

/etc/tapesave 

DESCRIPTION 

These shell scripts are provided as models. They are designed to provide a simple, interactive operator 
environment for file backup. Filesave.? is for daily disk-to-disk backup and tapesave is for weekly disk- 
to-tape. 

The suffix .? can be used to name another system where two (or more) machines share disk drives (or tape 
drives) and one or the other of the systems is used to perform backup on both. 

SEE ALSO 

shutdown(lM), volcopy(lM). 
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NAME 

getty - set the modes of a terminal 
SYNOPSIS 

/etc/getty name type delay 
DESCRIPTION 

Getty is normally invoked by init(S) as the first step in allowing users to login to the system. Lines in 
/etc/inittab tell init to invoke getty with the proper arguments. 

Name should be the name of a terminal in /dev (e.g., tty03); type should be a single character chosen from 
0, 1, 2, 3, 4, 5, or 6 (may vary locally) which selects a speed table in getty, or !, which tells getty to 
update /etc/utmp and exit; delay is relevant for dial-up ports only. It specifies the time in seconds that 
should elapse before the port is disconnected if the user does not respond to the login: request. 

First, getty types the login: message. The login: message depends on the speed table being used, and may 
include the characters that put the GE TermiNet 300 terminal into full-duplex, take the DASI terminals out 
of the plot mode, or put a TELETYPE.nh 

Model 37 into full-duplex. Then the user’s login name is read, a character at a time. 

While reading, getty tries to adapt to the terminal, speed, and mode that is being used. If a null character is 
received, it is assumed to be the result of a “break” (“interrupt”). The speed is then changed based on the 
speed table that getty is using, and login: is typed again. Subsequent breaks cause a cycling through the 
speeds in the speed table being used. 

The user’s login name is terminated by a new-line or carriage-return character. The latter results in the sys¬ 
tem being set to treat carriage returns appropriately. If the login name contains only upper-case alphabetic 
characters, the system is told to map any future upper-case characters into the corresponding lower-case 
characters. 

Finally, login{l) is called with the user’s login name as argument. 

Speed sequences for the speed tables: 

BllO; for 110 baud console TTY. 

0 B300-B150-B110-B1200; normal dial-up sequence starting at B300. 

1 B150; no sequence. 

2 B2400; no sequence. 

3 B1200-B300-B150-B110; normal dial-up sequence starting at B1200. 

4 B300; for console DECwriter. 

5 B9600; no sequence. 

6 B4800-B9600; for Tektronix 4014. 

SEE ALSO 

login(l), tty(4), inittab(5), utmp(5), init(8). 

BUGS 

Ideally, the speed tables would be read from a file, not compiled into getty. 
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NAME 

hasp - RJE (Remote Job Entry) to IBM 

SYNOPSIS 

/usr/hasp/haspinit 

/usr/hasp/hasphalt 

DESCRIPTION 

Hasp is the communal name for a collection of programs and a file organization that allow a UNIX system, 
equipped with an appropriate driver for the DQSl 1-B, to communicate with IBM’s Job Entry Subsystems by 
mimicking an IBM 2770 remote station. 

Hasp is initiated by the command haspinit and is terminated gracefully by the command hasphalt. While 
active, hasp runs in background and requires no human supervision. It quietly transmits, to the IBM sys¬ 
tem, jobs that have been queued by the command send{\C) and messages that have been entered by the 
command rjestat{\C). It receives, from the IBM system, print and punch data sets and message output. It 
enters the data sets into the proper UNIX directory and notifies the appropriate user of their arrival. It scans 
the message output to maintain a record on each of its jobs. It also makes these messages available for pub¬ 
lic inspection, so that rjestat{lC), in particular, may extract responses. 

Unless otherwise specified, all files and commands described below live in directory /usr/hasp (first excep¬ 
tions: send and rjestat). 

There are two sources of data that is to be transmitted by hasp from UNIX to an IBM Systeni/370. In both 
cases, the data is organized as files in pnch(5) format. The first is a single file haspmesg that is reserved 
for message input. It is written by the enquiry command rjestat(\C) and is assigned a priority for transmis¬ 
sion. The second source, containing the bulk of the data, consists of jobs that have been entered into the 
xmit* queue by the program haspqer. On completion of processing, send invokes haspqer. As each file is 
queued, a subordinate info/logx* file is created to save the name, user ID, login directory, and terminal ID 
of the user who is doing the queuing. Upon successful transmission of the data to the IBM system, 
haspdisp will move this information into the jobsout file and delete the info/logx* file. 

Each time haspinit is invoked, the xmit* xmit* queue is compacted, along with the associated info/logx* 
files, and its beginning and end are calculated. A three-digit sequence number specifying the first free slot 
at the end of the queue is written to file haspstat. This number is subsequently updated by haspqer each 
time that a new job is entered into the queue. A pointer to the beginning of the queue is maintained by 
haspmain. It is periodically compared to the current end of the queue to determine whether any jobs are 
waiting to be transmitted. A null lock-file hasplock is created with mode zero to prevent simultaneous 
updating of haspstat. 

In anticipation of receiving output, hasp always maintains a vacant file tmp* in its own directory. Output 
from the IBM system is initially written into this file and is classified as either a print data set, a punch data 
set, or message output. Print output is converted to an ASCII text file, with standard tabs. Form feeds are 
suppressed, but the last line of each page is distinguished by the presence of an extraneous trailing space. 
Punch output is converted to EBCDIC format. This classification and both conversions occur as the output 
is received; tmp* files are moved or copied into the appropriate user’s directory and assigned the name 
prnt* or pnch*, respectively, or placed into user directories under user-specified names, or used as input to 
programs to be automatically executed, as specified by the user. This process is driven by the “usr=...” 
specification. Hasp retains ownership of these files and permits read-only access to them. Files of message 
output are digested by hasp immediately and are not retained. 

A record is maintained for each job that passes through hasp. Identifying information is extracted contex¬ 
tually from files transmitted to and received from the IBM system. From each file transmitted, hasp 
extracts the job name, the programmer’s name, the user name, the destination directory name, and the mes¬ 
sage level. This information is temporarily stored, in the order of submission of jobs, in file jobsout. It is 
retrieved, by job name and programmer’s name, when the IBM system acknowledges the job and assigns a 
number to it. 
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The IBM system automatically returns an acknowledgement message for each job it receives. Other status 
messages are returned in response to enquiries entered by users and in response to enquiries that hasp itself 
generates every ten minutes. All messages received by hasp are appended to the resp file. The resp file is 
automatically truncated when it reaches 32,000 bytes. Each sequence of enquiries written to the message 
file haspmesg should be preceded by an identification card image of the form /*$UX<proce.s'5 id>%. The 
IBM system will echo back the first portion of this card image, as this is an illegal command. The appear¬ 
ance of process ids in the response stream permits responses to be passed on to the proper users. Hasp 
enters process id zero on all enquiries it generates on its own behalf. 

While it is active, hasp occupies at least the two process slots that are appropriated by haspinit. These slots 
are used to run haspmain, that supervises data transfers, as well as haspdisp, that performs dispatching 
functions; these two processes are connected by a pipe. The function of haspmain is to cycle repetitively, 
looking for data to transfer either to or from the IBM system. When it finds some, it spawns a child process, 
either haspxmit or hasprecv, to effect the transfer. It waits for its child to complete its task and then passes 
an event notice to haspdisp. Haspmain exits normally as soon as it detects the file haspstop (created by 
hasphalt), and exits reluctantly whenever it encounters a run of errors. An attempt is made to manage the 
null file haspdead so that it exists precisely when haspmain is not executing. Haspinit has the capability 
of dialing any remote IBM system with the proper hardware and software configuration. A file haspsoCf is 
created by hasphalt to signal that the phone should be hung up by haspmain. 

Ordinarily, haspdisp waits for event completion notices from haspmain. Haspdisp follows up the events 
described by directing output files, updating records, and notifying users. It may spawn the program 
haspcopy to copy output across file systems. Haspdisp references the system files /etc/passwd and 
/etc/utmp to correlate user names, numeric ids, and terminals. Normal termination of haspmain causes 
haspdisp to exit also. In the case of error termination, haspdisp delays about one minute and then reboots 
RJE by executing haspinit again. 

Event notices begin with a one-digit code. The code “0” alone signals normal termination. Other event 
notices consist of a code in the range 1 to 6 followed by the name of a file in the /usr/hasp directory. 
Notices are issued as each file in the xmit* queue is transmitted and as each tmp* file is filled with output. 
These files are moved to new temporary names before the event notice is composed. Transmitted files 
(code 1) are renamed zmit* and output files (codes 3-5) are renamed prt*, pch*, or msg*, depending on 
their type. When haspdisp gets around to following up on the events described, the files will either be 
deleted or moved to a permanent destination. 

Event notices are written to the log file at the time they are received by haspdisp. A typical section of the 
log looks as follows: 

lzmit283 

5msg61 

lzmit284 

5msg62 

3prt63 

Additional lines are written to the log by haspinit. Each reboot of haspinit is marked by a time stamp. If 
the previous execution of haspmain ended in error, an exception notice precedes the time stamp. Exception 
notices are formatted by haspmain and consist of a sequence of capital letters. The most common is 
AAAAA, that indicates five successive failures to acquire the line for a transmission to the host. A sequence 
of time stamps alternating with AAAAA indicates that the host is not responding to RJE. Each time the RJE 
facility is booted via the haspinit program, the log file is cleaned out. A copy of its last contents is placed 
in a file named slog. 

Most hasp files and directories are protected from unauthorized tampering. The exception is the pool direc¬ 
tory, that is provided so that send(\C) can create temporary files in the correct file system. Haspqer and 
rjestat(\C), the user’s interfaces to hasp, operate in setuid mode to contribute the necessary permission 
modes. Rjestat{lC), incidentally, extends to anyone who can login as rje complete freedom to enter con¬ 
sole commands. When invoked with a + argument, it suppresses the d that begins a display command and 
allows one to cancel or re-route jobs. 
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Some minimal oversight of each hasp subsystem is required. The hasp mailbox should be inspected and 
cleaned out periodically. The job directory should also be checked. The only files placed there are output 
files whose destination file systems are out of space. Users should be given a short period of time (say, a 
day or two), and then these files should be removed. 

Usage statistics are recorded in the directory /usr/hasp/usg, if it exists. Six files will be created and 
updated. Each will contain data on a per-user ID basis. File hasp.in.sum accumulates the number of 
blocks transmitted by hasp\ file hasp in.cnt records the number of transmissions; file hasp.in max records 
the size, in blocks, of the largest job sent. Files hasp.out.sum, hasp.out.cnt and hasp.out.max contain the 
same statistics for output received by hasp. The program usage may be used to print these statistics; 
“usage file [user IDl ...]’’ will print out the statistics gathered in file. If the optional user ID list is present, 
only the statistics for these user IDs will be printed. 

The configuration table /usr/rje/lines is accessed by all components of RJE. Its six columns may be labeled 
“host”, “system””, “directory”, “prefix”, “device”, and “parameters”. Each line of the table maxi¬ 
mum of eight) defines an RJE connection. “Host” is the name of a remote computer: A, B, C, U2, or U3. 
“System” is a string of capital letters identifying UNIX systems. The first specifies where the RJE connec¬ 
tion is normally terminated; the remainder specify where it may be backed-up to if the primary RJE system 
goes down. “Directory” is the directory name of the servicing RJE subsystem. “Prefix” is the string 
prefixed (redundantly) to several crucial files and programs in the directory: hasp, hasp2, uvac. “Device” 
is the name of the controlling DQS-1 IB, with /dev/ excised. “Parameters” contains information on the type 
of connection to make. Each subfield is separated by the delimiter :. Any or all fields may be omitted; 
however, the fields are positional. All but trailing delimiters must be present. For example, in 

1200:512::::9-555-1212 

subfields 3, 4, and 5 are missing, but the delimiters are present. 

The first subfield specifies the amount of space (5) in blocks that RJE tries to maintain on file systems it 
touches. The default is 0 blocks. Several RJE programs, including the send(lC) command, use the ustat(2) 
system call to determine the remaining capacity of the file systems they use. Send shuts down and haspinit 
issues a warning when no more than 1.55 blocks are available; haspmain stops accepting output from the 
host when the capacity falls to 1.25 blocks; RJE becomes dormant, until conditions improve, when the 
capacity falls to 5 blocks. If the space on the file system specified by the user on the “usr=” card would be 
depleted to a point below 5, the file will be put in the “job” subdirectory of the connection’s home direc¬ 
tory (e.g., /usr/hasp2/job), rather than in the place that the user requested. The second subfield specifies 
the size in blocks of the largest file that can be accepted from the host without truncation taking place. The 
default is no truncation. The third subfield specifies burst page removal. If this subfield contains the letter 
y, RJE will not try to remove any burst pages from returned output. Any other value in this subfield will 
cause RJE to scan for and remove the leading burst pages. For UNIVAC hosts this flag is inoperative and no 
burst pages are ever removed. Embedded and trailing burst pages are never removed. The default is n. 
The fourth subfield specifies what to do with undeliverable returning jobs. If an output file is undeliverable 
for any reason other than file system space limitations (e.g., missing or invalid “usr=” card) and this 
subfield contains the letter y, the output will be retained in the “job” subdirectory of the home directory 
(e.g., /usr/hasp/job). If this subfield has any other value, undeliverable output will be discarded. The 
default is n. The fifth subfield specifies the status of the interactive status terminal for this line. If the 
subfield contains an i, all console status facilities are inhibited (e.g., rjestat{\0 will not behave like a status 
terminal, and the ten-minute automatic status inquiry is inhibited). This subfield must contain an i for UNI¬ 
VAC configurations. In all cases, the normal non-interactive uses of rjestat{\C) will continue to function. 
The default is y. Subfield six contains a telephone number to be used to call a host machine. The telephone 
number may contain the digits 0 thru 9 and the character - which denotes a pause If the telephone number 
is not present, no dialing is attempted and a leased line is assumed. 

Sign-on is controlled by the existence of a signon file in the controlling directory (e.g., /usr/basp/signon). 
If this file is present its contents are sent as a sign-on message to the host system. 

The file /usr/rje/sys contains the single-letter name of the current UNIX system. An RJE connection will be 
considered available if this is its primary system or if this is one of its backup systems and the associated 
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directory is mounted. Send{\C) and rjestat{\C) select an available connection by indexing on the “host” 
field of the configuration table. Hasp programs index on the “prefix” field. A subordinate directory, sque, 
exists in /usr/rje for use by haspdisp and shqer programs. This directory holds those output files that have 
been designated as standard input to some executable file. This designation is done via the “usr=...” 
specification. Haspdisp places the output files here and updates the file log to specify the order of execu¬ 
tion, arguments to be passed, etc. Shqer executes the appropriate files. The shqer must be started in 
/etc/rc. A program called compact compacts the log file. It should be executed before shqer and RJE have 
been started. 

All HASP programs are reentrant; therefore, if more than one HASP is to be run on a given UNIX system, 
simply link (via /«(!)) HASP2 program names to HASP names in /usr. 

FILES 

Configuration-dependent and general-purpose RJE files: 


/dev/rjei 

DQSll-B 

/dev/tty? 

terminals 

/etc/utmp 

list of active users 

/etc/passwd 

user population 

/usr/rje/sys 

UNIX system name, e.g., “A” 

/usr/rje/lines 

UNIX RJE lines configuration table 

/usr/rje/sque/log 

log information for shqer 

User files : 


/usr/mail/* 

a user’s mailbox 

*/prnt* 

a user’s print data set 

*/pnch* 

a user’s punch data set 

Hasp files (relative to the directory entry in the RJE configuration table): 

hasp* 

mostly programs 

haspdead 

inactive flag 

haspsoff 

dial-up hang-up signal 

haspstop 

halt signal 

haspmesg 

message slot 

haspstat 

queue end record 

hasplock 

lockout file 

xmit* 

jobs queued 

info/logx* 

haspqer loginfo 

job/* 

output from jobs whose file systems are out of space 

jobsout 

fifo job store 

tmp* 

output files 

log 

event log 

resp 

concatenated responses from the IBM system 

status 

RJE message of the day 

pool/stm* 

send(\C) temporaries 

usg/* 

usage statistics 

signon 

contains card image for signon 


SEE ALSO 

rjestat(lC), send(lC), dqs(4), pnch(5), mk(8). 

Guide to IBM Remote Job Entry for PWB/UNIX Users by A. L. Sabsevitz and E. J. Finger. 

System Components: IBM 2770 Data Communication System, IBM SRL GA27-3013. 

OSP/Sl HASP II Version 4 System Programmer's Guide IBM SRL GC27-6992. 

DIAGNOSTICS 

Haspinit provides brief error messages describing obstacles to bringing up hasp. They can best be under¬ 
stood in the context of the RJE source code. The most frequently occurring one is “cannot open /dev/rjei”. 
This may occur if the DQS-llB status register shows something other than READY (octal 200). It will also 



HASP(8) 


(Obsolescent) 


HASP(8) 


occur if another process already has the DQS-llB open, or if the exclusive use flag (_dqsx+3, _dqsx+73, 
etc.) has remained set after a close of the DQS-1 IB. 

Once hasp has been started, users should assist in monitoring its performance, and should notify operations 
personnel of any perceived need for remedial action. Rjestat{\C) will aid in diagnosing the current state of 
RJE. It can detect, with some reliability, when the far end of the communications line has gone dead, and 
will report in this case that the host computer is not responding to RJE. It will also attempt to reboot hasp if 
it detects a prolonged period of inactivity on the DQS-llB. 

BUGS 

The name hasp is an anachronism. It is used only as a collective name and could represent HASP, JES2, 
ASP, etc. 
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NAME 

ink - process control initialization 

SYNOPSIS 

/etc/init [ state ] 

DESCRIPTION 

Init is invoked inside UNIX as the last step in the boot procedure. It is process number one, and is the 
ancestor of every other process in the system. As such, it can be used to control the process structure of the 
system. If init is invoked with an argument by the super-user, it will cause a change in state of process one. 

Init has 9 states, 1 through 9; it is invoked by the system in state 1, and it performs the same functions on 
entering each state. When a state is entered, init reads the file /etc/inittab. Lines in this file have the for¬ 
mat: 

state:id:flags:command 

All lines in which the state field matches init's current state are recognized. If a process is active under the 
same two character id as a recognized line, it may be terminated (signal 15), killed (signal 9), or both by 
including the flags t and k in the order desired. The signal is sent to all processes in the process group 
associated with the id. The command field is saved for later execution. 

After reading /etc/inittab and signaling running processes as required, but before invoking any processes 
under the new state, /etc/rc is invoked with three arguments. This command file performs housekeeping 
such as removing temporary files, mounting file systems, and starting daemons. The three arguments are 
the current state, the number of times this state has been entered previously, and the prior state. Init will 
also execute /etc/rc at the request of the operating system (e.g., when recovering from power failure). In 
this last case, the first argument has an x appended to it. 

When /etc/rc has finished executing, init invokes all commands waiting to be executed. (A command is 
waiting to be executed if there is no process currently running that has the same id as the command.) The 
flag c (continuous) requires the command to be continuously reinvoked whenever the process with that id 
dies. The flag o (off) causes the command to be ignored. This is useful for turning lines off without exten¬ 
sive editing. Otherwise, the command is invoked a maximum of one time in the current state. 

Init invokes the command field read from /etc/inittab by opening / for reading and writing on file descrip¬ 
tors 0, 1, and 2, resetting all signals to system default, setting up a new process group {setpgrpil)), and 
execing: 

/bin/sh -c exec command 

DIAGNOSTICS 

When init can do nothing else because of a missing /etc/inittab or when it has no children left, it will try to 
execute a shell on /dev/console. When the problem has been fixed, it is necessary to change states, and ter¬ 
minate the shell. 


BUGS 

Init does not complain if the state-id pairs in /etc/inittab are not unique. For any given pair, the last one in 
the file is valid. 

FILES 

/etc/inittab 

/etc/rc 

/bin/sh 

/dev/console 

SEE ALSO 

login(l), sh(l), exec(2), setpgrp(2), inittab(5), getty(8). 
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NAME 

makekey - generate encryption key 

SYNOPSIS 

/usr/lib/makekey 

DESCRIPTION 

Makekey improves the usefulness of encryption schemes depending on a key by increasing the amount of 
time required to search the key space. It reads 10 bytes from its standard input, and writes 13 bytes on its 
standard output. The output depends on the input in a way intended to be difficult to compute (i.e., to 
require a substantial fraction of a second). 

The first eight input bytes (the input key) can be arbitrary ASCII characters. The last two (the salt) are best 
chosen from the set of digits,/, and upper- and lower-case letters. The salt characters are repeated as the 
first two characters of the output. The remaining 11 output characters are chosen from the same set as the 
salt and constitute the output key. 

The transformation performed is essentially the following: the salt is used to select one of 4,096 crypto¬ 
graphic machines all based on the National Bureau of Standards DES algorithm, but broken in 4,096 differ¬ 
ent ways. Using the input key as key, a constant string is fed into the machine and recirculated a number of 
times. The 64 bits that come out are distributed into the 66 output key bits in the result. 

Makekey is intended for programs that perform encryption (e.g., ed{\) and crypt{\)). Usually, its input and 
output will be pipes. 

SEE ALSO 

crypt(l), ed(l), passwd(5). 
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NAME 

mk - how to remake the system and commands 
DESCRIPTION 

All source for UNIX is in a source tree distributed in the directory /usr/src. This includes source for the 
operating system, libraries, commands, miscellaneous files necessary to the running system, and procedures 
to create everything from this source. 

The top level consists of the directories cmd, lib, uts, head, and stand as well as commands to remake 
each of these “directories”. These commands are named :mk, which remakes everything, and :mkdir 
where dir is the directory to be recreated. Each recreation command will make all or part of the piec; over 
which it has control. :mk will run each of these commands and thus recreate the whole system. 

The lib directory contains libraries used when loading user programs. The largest and most important of 
these is the C library. All libraries are in sub-directories and are created by a makefile or runcom. A run- 
com is a Shell command procedure used specifically to remake a piece of the system. :mklib will rebuild 
the libraries that are given as arguments. The argument \* will cause it to remake all libraries. 

The head directory contains the header files, usually found in /usr/include on the running system. 
:mkhead will install those header files that are given as arguments. The argument \* will cause it to install 
all header files. 

The uts directory contains the source for the UNIX operating system. :mkuts (no arguments) invokes a 
series of makefiles that will recreate the operating system. 

The stand directory contains stand-alone commands and boot programs. :mkstand will rebuild and install 
these programs. 

The cmd directory contains files and directories. :mkcmd transforms source into a command based upon its 
suffix ( 1, .y, .c, .s, .sh), or its makefile (see make(\)) or runcom. A directory is assumed to have a makefile 
or a runcom that will take care of creating everything associated with that directory and its sub-directories. 
Makefiles and runcoms are named command mk and command.rc respectively. 

:mkcmd will recreate commands based upon a makefile or runcom if one of them exists; alternatively com¬ 
mands are recreated in a standard way based on the suffix of the source file. All commands requiring more 
than one file of source are grouped in sub-directories, and must have a makefile or a runcom. C programs 
(.c) are compiled by the C compiler and loaded stripped with shared text. Assembly language programs (.s) 
are assembled with /usr/include/sys.s which contains the system call definitions. Yacc programs (.y) and 
lex programs (.1) are processed by yacc{l) and lex(\) respectively before C compilation. Shell programs 
(.sh) are copied to create the command. Each of these operations leaves a command in ./cmd which is then 
installed by using /etc/install. 

The arguments to :mkcmd are either command names, or subsystem names. The subsystems distributed 
with UNIX are: acct, graf, rje, sees, and text. Prefacing the :mkcmd instruction with an assignment to the 
Shell variable $ARGS will cause the indicated components of the subsystem to be rebuilt. 

The entire secs subsystem can be rebuilt by: 

/usr/src/:mkcmd sees 

while the delta component of secs can be rebuilt by: 

ARGS=:"delta" /usr/src/:mkcmd sees 

The log command, which is a part of the stat package, which is itself a part of the graf package, can be 
rebuilt by: 

ARGS="stat log" /usr/src/:mkcmd graf 
The argument \* will cause all commands and subsystems to be rebuilt. 

Makefiles, both in 7cmd and in sub-directories, have a standard format. In particular imkcmd depends on 
there being entries for install and clobber. Install should cause everything over which the makefile has 
jurisdiction to be made and installed by /etc/install. Clobber should cause a complete cleanup of all 
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unnecessary files resulting from the previous invocation. 

Most of the runcoms in 7cmd (as opposed to sub-directories) relate in particular to a need for separated 
instruction and data (I and D) space. 

In the past, dependency on the C library routine ctime{2)C) was also important. Ctime had to be modified 
for all systems located outside of the eastern time zone, and all commands that referenced it had to be 
recompiled. Ctime has been rewritten to check the environment (see environil)) for the time zone. This 
results in time zone conversions possible on a per-process basis, /etc/profile sets the initial environment for 
each user, and /etc/rc sets it for certain system daemons. These two programs are the only ones which must 
be modified outside of the eastern time zone. 

An effort has been made to separate the creation of a command from source, and its installation on the run¬ 
ning system. The command /etc/install is used by :mkcmd and most makefiles to install commands in the 
proper place on the running system. The use of install allows maximum flexibility in the administration of 
the system. Install makes very few assumptions about where a command is located, who owns it, and what 
modes are in effect. All assumptions may be overridden on invocation of the command, or more perma¬ 
nently by redefining a few variables in install. The object is to install a new version of a command in the 
same place, with the same attributes as the prior version. 

In addition, the use of a separate command to perform installation allows for the creation of test systems in 
other than standard places, easy movement of commands to balance load, and independent maintenance of 
makefiles. The minimization of makefiles in most cases, and the site independence of the others should 
greatly reduce the necessary maintenance, and allow makefiles to be considered part of the standard source. 

SEE ALSO 

install(lM), make(l). 
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NAME 

rc - system initialization shell script 

SYNOPSIS 

/etc/rc 

DESCRIPTION 

The /etc/rc file is executed by m/f (8) whenever the init state is changed. 

SEE ALSO 

init(8). 
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NAME 

rje - RJE (Remote Job Entry) to IBM 

SYNOPSIS 

/usr/rje/rjeinit 

/usr/rje/rjehalt 

DESCRIPTION 

RJE is the communal name for a collection of programs and a file organization that allows a UNIX system, 
equipped with a KMCll-B, KMCll driver, and associated Virtual Protocol Machine (VPM) software, to 
communicate with IBM’s Job Entry Subsystems by mimicking an IBM 360 remote multileaving work sta¬ 
tion. 

Implementation. 

RJE is initiated by the command rjeinit and is terminated gracefully by the command rjehalt. While active, 
RJE runs in the background and requires no human supervision. It quietly transmits, to the IBM system, 
jobs that have been queued by the send{\C) command, and operator requests that have been entered by the 
rjestat{\C) command. It receives, from the IBM system, print and punch data sets and message output. It 
enters the data sets into the proper UNIX directory and notifies the appropriate user of their arrival. It scans 
the message output to maintain a record on each of its jobs. It also makes these messages available for pub¬ 
lic inspection, so that rjestat{lC), in particular, may extract responses. 

Unless otherwise specified, all files and commands described below reside in directory /usr/rje (first excep¬ 
tions: send and rjestat). 

There are two sources of data to be transmitted by RJE from UNIX to an IBM System/370. In both cases, 
the data is organized as files in the /usr/rje/squeue directory. The first are files named co* which are cre¬ 
ated by the enquiry command rjestat{lC). The second source, containing the bulk of the data, are files 
named rd* or sq* which have been created by send and queued by the program rjeqer. On completion of 
processing send invokes rjeqer. Rjeqer and rjestat inform the program rjexmit that a file has been queued 
via the file joblog. Upon successful transmission of the data to the IBM machine, rjexmit removes the 
queued file. As files are transmitted and received, the program rjedisp writes an entry containing the date, 
time, file name, logname, and number of records in the file acctlog, if it exists. This file can be used for 
local logging or accounting information, but is not used elsewhere by RJE. The use of this information is 
up to the RJE administrator. 

Each time rjeinit is invoked, the joblog file is truncated and recreated from the contents of the 
/usr/rje/squeue directory. During this time, rjeinit prevents simultaneous updating of the joblog file. 

Output from the IBM system is classified as either a print data set, a punch data set, or message output. 
Print output is converted to an ASCII text file, with standard tabs. Form feeds are suppressed, but the last 
line of each page is distinguished by the presence of an extraneous trailing space. Punch output is con¬ 
verted to pnch(5) format. This classification and both conversions occur as the output is received. Files are 
moved or copied into the appropriate user’s directory and assigned the name prut* or pnch*, respectively, 
or placed into user directories under user-specified names, or used as input to programs to be automatically 
executed, as specified by the user. This process is driven by the ‘ ‘usr=...” specification. RJE retains owner¬ 
ship of these files and permits read-only access to them. Message output is digested by RJE immediately 
and is not retained. 

A record is maintained for each job that passes through RJE. Identifying information is extracted contextu¬ 
ally from files transmitted to and received from the IBM system. This information is stored and used by the 
rjedisp program for IBM job acknowledgements and delivery of output files. 

The IBM system automatically returns an acknowledgement message for each job it receives. Other status 
messages are returned in response to enquiries entered by users. All messages received by RJE are 
appended to the resp file. The resp file is automatically truncated when it reaches 70,000 bytes. Each 
enquiry is preceded and followed by an identification card image of the form ''$\JX<process id>'\ The 
IBM system will echo this back as an illegal command. The appearance of process ids in the response 
stream permits responses to be passed on to the proper users. 
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While it is active, RJE occupies at least the three process slots that are appropriated by rjeinit. These slots 
are used to run rjexmit, the transmitter, rjerecv, the receiver, and rjedisp, the dispatcher. These three pro¬ 
cesses are connected by pipes. The function of each is as follows: 

rjexmit Cycles repetitively, looking for data to transmit to the IBM system. After transmission, rjexmit 
passes an event notice to rjedisp. If rjexmit encounters a stop file, (created by rjehalt), it exits 
normally. In the case of error termination, rjexmit reboots RJE by executing rjeinit. 

rjerecv Cycles repetitively, looking for data returning from the IBM machine. Upon receipt of data, 
rjerecv notifies either rjexmit or rjedisp of the event (transfer information is sometimes passed to 
rjexmit). Rjerecv exits normally at the first appropriate moment when it encounters the file stop, 
or exits reluctantly when it encounters a run of errors. 

rjedisp Follows up event notices by directing output files, updating records, and notifying users. Rjedisp 
references the system files /etc/passwd and /etc/utmp to correlate user names, numeric ids, and 
terminals. Termination of rjerecv causes rjedisp to exit also. 

Rjeinit has the capability of dialing any remote IBM system with the proper hardware and software 
configuration. 

Most RJE files and directories are protected from unauthorized tampering. The exception is the spool direc¬ 
tory. It is used by send(\C) to create temporary files in the correct file system. Rjeqer and rjestat{\C), the 
user’s interfaces to RJE, operate in setuid mode to contribute the necessary permission modes. 

Administration. 

Some minimal oversight of each RJE subsystem is required. The RJE mailbox should be inspected and 
cleaned out periodically. The job directory should also be checked. The only files placed there are output 
files whose destination file systems are out of space. Users should be given a short period of time (say, a 
day or two), and then these files should be removed. 

The configuration table /usr/rje/lines is accessed by all components of RJE. Each line of the table (maxi¬ 
mum of 8) defines an RJE connection. Its seven columns may be labeled host, system, directory, prefix, 
device, peripherals and parameters. These columns are described as follows: 

host The name of a remote IBM computer (e.g., A B C). This string can be up to 5 characters, 
system 

The name of a UNIX system. This name should be the same as the system name from uname{\). 

directory 

This is the directory name of the servicing RJE subsystem (e.g., /usr/rjel). 

prefix This is the string prefixed (redundantly) to several crucial files and programs in directory (e.g., 
rjel, rje2, rje3). 

device 

This is the name of the controlling VPM device, with /dev/ excised, 
peripherals 

This field contains information on the logical devices (readers, printers, punches) used by RJE. 
Each subfield is separated by and is described as follows: 

(1) Number of logical readers. 

(2) Number of logical printers. 

(3) Number of logical punches. 

Note: the number of peripherals specified for an RJE subsystem must agree with the number of 
peripherals which have been described on the remote machine for that line. 

parameters 

This field contains information on the type of connection to make. Each subfield is separated by :. 
Any or all fields may be omitted; however, the fields are positional. All but trailing delimiters 
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must be present. For example, in 

1200:512:::9-555-1212 

subfields 3 and 4 are missing, but the delimiters are present. Each subfield is defined as follows: 

(1) space 

This subfield specifies the amount of space (5) in blocks that RJE tries to maintain on file 
systems it touches. The default is 0 blocks. Send will not submit jobs and rjeinit issues a 
warning when less than LSS" blocks are available; rjerecv stops accepting output from the 
host when the capacity falls to S blocks; RJE becomes dormant, until conditions improve. 
If the space on the file system specified by the user on the “usr=” card would be depleted 
to a point below S, the file will be put in the job subdirectory of the connection’s home 
directory, rather than in the place that the user requested. 

(2) size This subfield specifies the size in blocks of the largest file that can be accepted from the 

host without truncation taking place. The default is no truncation. 

(3) badjobs 

This subfield specifies what to do with undeliverable returning jobs. If an output file is 
undeliverable for any reason other than file system space limitations (e.g., missing or 
invalid “usr=” card) and this subfield contains the letter y, the output will be retained in 
the job subdirectory of the home directory, and login rje is notified. If this subfield con¬ 
tains an n or has any other value, undeliverable output will be discarded. The default is n. 

(4) console 

This subfield specifies the status of the interactive status terminal for this line. If the 
subfield contains an i, all console status facilities are inhibited (e.g., rjestat(\C) will not 
behave like a status terminal). In all cases, the normal non-interactive uses of rjestat(lC) 
will continue to function. The default is y. 

(5) dial-up 

This subfield contains a telephone number to be used to call a host machine. The tele¬ 
phone number may contain the digits 0 thru 9 and the character - which denotes a pause. 
If the telephone number is not present, no dialing is attempted and a leased line is 
assumed. 

Sign-on is controlled by the existence of a signon file in the home directory. If this file is present, its con¬ 
tents are sent as a sign-on message to the host system. If this file does not exist, a blank card is sent. Sign- 
off is controlled in the same way, except that the signoff file is sent by rjehalt if it exists. If the signoff file 
does not exist, a “/^signoff” card is sent. These files should be ASCII text and no more than 80 characters. 

Send(\C) and rjestat(lC) select an available connection by indexing on the host field of the configuration 
table. RJE programs index on the prefix field. A subordinate directory, sque, exists in /usr/rje for use by 
rjedisp and shqer programs. This directory holds those output files that have been designated as standard 
input to some executable file. This designation is done via the “usr=...” specification. Rjedisp places the 
output files here and updates the file log to specify the order of execution, arguments to be passed, etc. 
Shqer executes the appropriate files. 

All RJE programs are shared text; therefore, if more than one RJE is to be run on a given UNIX system, sim¬ 
ply link (via ln(\)) RJE2 program names to RJE names in /usr. 

SEE ALSO 

rjestat(lC), send(lC), vpm(4), pnch(5), mk(8). 

UNIX Remote Job Entry User’s Guide by K. A. Kelleman. 

UNIX Remote Job Entry Administrative Guide by M. J. Fitton. 

Setting Up UNIX. 

DIAGNOSTICS 

Rjeinit provides brief error messages describing obstacles encountered while bringing up RJE. They can 
best be understood in the context of the RJE source code. The most frequently occurring one is “cannot 
open /dev/vpm?’’. This may occur if the VPM script has not been started, or if another process already has 
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the VPM device open. 

Once RJE has been started, users should assist in monitoring its performance, and should notify operations 
personnel of any perceived need for remedial action. Rjestat{\C) will aid in diagnosing the current state of 
RJE. It can detect, with some reliability, when the far end of the communications line has gone dead, and 
will report in this case that the host computer is not responding to RJE. It will also attempt to reboot RJE if 
it detects a prolonged period of inactivity on the KMC-1 IB. 
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NAME 

romboot - special ROM bootstrap loaders 
DESCRIPTION 

To bootstrap programs from various storage media, standard DEC ROM bootstrap loaders are often used. 
However, such standard loaders may not be compatible with UNIX bootstrap programs or may not exist on 
a particular system. Thus, special bootstrap loaders were designed that may be cut into a programmable 
ROM (M792 read-only-memory) or manually toggled into memory. 

Each program is position-independent, that is, it may be located anywhere in memory. Normally, it is 
loaded into high core to avoid being overwritten. Each reads one block from drive 0 into memory starting 
at address 0 and then jumps to address 0. To minimize the size, each assumes that a system INIT was gen¬ 
erated prior to execution. Also, the address of one of the device registers is used to set the byte count regis¬ 
ter or word count register. In each case, this will read in at least 256 words, which is the maximum size of 
bootstrap programs. 

On disk devices, block 0 is read; on tape devices, one block from the current position. Thus, the tape 
should be positioned at the load point (endzone if DECtape) prior to booting. Also, the standard DEC boot¬ 
strap loader for magnetic tape may be emulated by positioning the tape at the load point and executing the 
bootstrap loader twice. 

By convention, on PDF 11/45 systems, address 773 000 is the start of a tape bootstrap loader, and 773 020 
the start of a disk bootstrap loader. The actual loaders used depend on the particular hardware 
configuration. 

SEE ALSO 

70boot(8), unixboot(8). 

CODE 


TCll - DECtape 
012700 

mov 

$tcba,r0 


177346 

010040 

mov 

r0,-(r0) 

/use tc addr for wc 

012740 

mov 

$3,-(r0) 

/read bn forward 

000003 

105710 1: 

tstb 

(rO) 

/wait for ready 

002376 

bge 

lb 


112710 

movb 

$5,(r0) 

/read forward 

000005 

105710 1: 

tstb 

(rO) 

/wait for ready 

002376 

bge 

lb 


005007 

clr 

pc 

/transfer to zero 

TU10 - Magnetic Tape 
012700 

mov 

$mtcma,r0 


172526 

010040 

mov 

r0,-(rO) 

/use mt addr for be 

012740 

mov 

$60003,-(rO) 

/read, 800 bpi, 9 track 

060003 

105710 1: 

tstb 

(rO) 

/wait for ready 

002376 

bge 

lb 


005007 

clr 

pc 

/transfer to zero 
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TU16 - Magnetic Tape 


012700 

mov 

$mtwc,rO 


172442 

012760 

mov 

$1300,30(r0) 

/set 800 bpi, PDP format 

001300 

000030 

010010 

mov 

rO,(ifl) 

/use mt addr for wc 

012740 

mov 

$71,-(r0) 

/read 

000071 

105710 1: 

tstb 

(rO) 

/wait for ready 

002376 

bge 

lb 


005007 

clr 

pc 

/transfer to zero 

RK05 - Disk Pack 
012700 

mov 

$rkda,rO 


177412 

005040 

clr 

-(rO) 


010040 

mov 

rO,-(rO) 

/use rk addr for wc 

012740 

mov 

$5,-(rO) 

/read 

000005 

105710 1: 

tstb 

(rO) 

/wait for ready 

002376 

bge 

lb 


005007 

clr 

pc 

/transfer to zero 

RP03 - Disk Pack 
012700 

mov 

$rpmr,rO 


176726 

005040 

clr 

-(rO) 


005040 

clr 

-(rO) 


005040 

clr 

-(rO) 


010040 

mov 

rO,-(rO) 

/use rp addr for wc 

012740 

mov 

$5,-(rO) 

/read 

000005 

105710 1: 

tstb 

(rO) 

/wait for ready 

002376 

bge 

lb 


005007 

clr 

pc 

/transfer to zero 

RP04 - Disk Pack 

012700 

mov 

$rpcsl,rO 


176700 

012720 

mov 

$21,(r0)+ 

/read-in preset 

000021 

012760 

mov 

$10000,30(rO) 

/set to 16-bits/word 

010000 

000030 

010010 

mov 

rO,(iO) 

/use rp addr for wc 

012740 

mov 

$71,-(r0) 

/read 

000071 

105710 1: 

tstb 

(rO) 

/wait for ready 

002376 

bge 

lb 


005007 

clr 

pc 

/transfer to zero 
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NAME 

rp6fmt - format and/or check RP06 disk packs 
DESCRIPTION 

rp6jmt will format new RP06 packs and check used packs (with write inhibited). The program reports the 
location and type of errors encountered, including ECC correctable error burst sizes. 

EXECUTION 

The following example shows how to load rp6fmt on a VAX-11/780 with a UNIX 3.0 updated floppy disc: 
»>r> 

HALTED AT nnnnnnnn 

»>B<cr> 

CPU HALTED 

INIT SEQ DONE 

HALT INST EXECUTED 

HALTED AT nnnnnnnn 

LOAD DONE, nnnnnnnnn BYTES LOADED 

$$ 

To execute rp6fmt, type /stand/rp6fmt after the standalone shell prompt $$. The formatter will print out 
its command vocabulary, and proceed inter-actively. If one wishes to format a pack on disk drive 1, for 
example, the command is dlf. The program will double check format requests, as pack contents will be 
destroyed. 

COMMANDS 

m n MBA with drive doing the format is n. (defaults to 0) 

d n drive with the pack to be formatted or checked is n. (drive number must be between 1 and 7) 

f format pack 

c check pack format 

q quit 

V print vocabulary 

R n set the error report level to n. 

X will tell you about the available report levels. 

The X command will explain the Report Level options the first time it is executed. Subsequent execution 
by the operator or by the program during error logging, will merely print the information defined by the 
current report level. 

FILES 

/stand/rp6fmt 

SEE ALSO 

vaxops(8). 
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NAME 

sar - system activity report package 
DESCRIPTION 

Sar is the first (tentative) piece of an overall UNIX measurement and statistics package; the data that are 
collected and the output formats are not yet final. 

The operating system contains a number of counters that are incremented as various system actions occur. 
These include several time counters (that are incremented each 60th of a second depending on the CPU 
mode), I/O activity counters, switching and system-call counters, and file-access counters. The system 
activity package writes system activity parameters periodically on a binary file. It also generates a daily 
system activity report that covers the prime period (from 8:00 to 18:00). 

The data collection and report generation are controlled by entries in crontab (see cron(lM)). The data 
collection program is normally activated every hour on the hour; the report generation once a day. 

Every time the system is booted, a special record is written to the daily data file, since all the system activ¬ 
ity counters restart from zero at that time. This process is done while executing /etc/rc see (m//(8)) during 
UNIX initialization. It produces an entry on the daily report showing the restart time. 

The daily reports are deposited in /usr/adm/sa/sarJJ where dd are digits representing the day of the 
month. A report can be printed (e.g., cat /usr/adm/sa/sar05) any time before it is removed the following 
week. 

The structure of the binary daily data file is: 
struct sa { 

struct sysinfo si; /* defined in /usr/include/sys/sysinfo.h */ 
long dO; /* number of reads and writes of disk 0 */ 

long dl; /* number of reads and writes of disk 1 */ 

long d2; /* number of reads and writes of disk 2 */ 

long ts; /* time stamp in time_t format */ 

); 


FILES 

/usr/adm/sa/saJ£/ 

/usr/adm/sa/sarJcf 

/tmp/sa.adrfl 


daily data file 
daily report file 
address file 
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NAME 

tapeboot - magnetic tape bootstrap program 
DESCRIPTION 

Tapeboot handles the problem of booting a PDP-11/45 or PDP-11/70 from a TUlO or TU16 tape transport. 
In both cases, the tape density is 800 bpi. The complete program fits in one 512 byte block, but is dupli¬ 
cated so that one copy resides in block 0 and another in block 1. Thus, both the standard DEC ROM boot¬ 
strap loaders and the special ROM loaders will work. For example, to create a boot tape, execute: 

cat /stand/tapeboot program-to-hoot >/dev/mt0 

To boot from magnetic tape, read the first record of the tape into memory starting at address 0 and then 
jump to address 0, using a special ROM or some manual procedure (toggle in the program). The bootstrap 
program relocates itself to high core as specified when assembled (typically 24K words, maximum of 28K). 
It then determines whether to use the TUIO code or the TU16 code. The TUIO is used if the TMll com¬ 
mand register (772 522) exists and the function (bits <3:1>) is non-zero, otherwise the TU16 is used. It 
then types on the console UNIX tape boot loader, rewinds the tape, reads two blocks to skip past itself on 
the tape, clears memory, and reads the rest of the tape, to the tape mark, into memory starting at address 0. 
If address 0 contains 000 407, a UNIX a.out program is assumed and the first 8 words are stripped off by 
relocating the loaded program toward address 0. Finally, a jump to address 0 is done by executing 
jsr pc,*$0. 

If there is an error while reading the tape, the bootstrap program will type tape error and attempt to read 
the record again. 

FILES 

/stand/tapeboot TU10/TU16 magtape bootstrap 
/usr/src/stand source directory 
SEE ALSO 

unixboot(8). 
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NAME 

unixboot - UNIX startup and boot procedures 
DESCRIPTION 

How to start UNIX. UNIX is started by placing it in core at location zero and transferring to zero. Since the 
system is not reenterable, it is necessary to read it in from disk or tape. See diskboot(8) or tapehoot(S). 

The switches. On systems with console switches, the switches are examined 60 times per second, and the 
contents of the address specified by the switches are displayed in the display register. If the switch address 
is even, the address is interpreted in kernel (system) space; if odd, the rounded-down address is interpreted 
in the current user space. 

Init. The operating system invokes init{%) as process number 1. It comes up in state one which is conven¬ 
tionally single-user. 

FILES 

/unix UNIX code 
SEE ALSO 

70boot(8), diskboot(8), init(8), romboot(8), tapeboot(8). 
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NAME 

uvac - RJE (Remote Job Entry) to UNIVAC 

SYNOPSIS 

/usr/uvac/uvacinit 

/usr/uvac/uvachalt 

DESCRIPTION 

Uvac is the communal name for a collection of programs and a file organization that allow a UNIX System, 
equipped with an appropriate driver for the DQSll-A, to communicate with a UNIVAC 1100 Series pro¬ 
cesser. This facility includes code that must run on the UNIVAC processor, under any Level 32 (or later) 
UNIVAC 1100 Executive that supports the Remote Symbiont Interface (RSI). 

Uvac is initiated by the command uvacinit and is terminated gracefully by the command uvachalt. While 
active, uvac runs in background and requires no human supervision. It quietly transmits to the UNIVAC 
system jobs that have been queued by the command send{\C). It receives from the UNIVAC system print 
data sets. It enters the data sets into the proper UNIX directory and notifies the appropriate user of their 
arrival. 

Other than name changes {uvac in place of hasp), non-existence of transparent mode (no punch files), non¬ 
existence of interactive rjestat{\C) capabilities, and use of ASCII format in place of EBCDIC format, 
hasp{%) should be referenced for information on this facility. 
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NAME 

vaxops - VAX-11/780 console operations 
DESCRIPTION 

The procedures described here include the major operational sequences involved in running UNIX on the 
VAX-11/780 system. The following notation is used: 

1. Special characters are enclosed in <> (e.g., <ctl> represents the “control” key, and <cr> stands for the 
“carriage return” key). 

2. Items within {}s are mandatory substitutions. 

DAILY PROCEDURES 
Disk Boot 

This procedure can be used only on a system with a floppy disk updated for use with UNIX. If the floppy 
disk has not been so updated, the sequences shown below under UNIX Floppy Update must be performed. 

When the system is first turned on, the console prompt »> is printed. If UNIX has been shut down, but not 
halted (see Bringing the System Down), the operator must type <ctl>p to get into console mode. After the 
prompt, type H<cr> to halt the system. 

With the system halted, any of the console commands may be executed as described below under Console 
Operation. 

To boot the stand-alone shell (sash) the operator types B<cr>. The following is an example of this opera¬ 
tion as seen on the console, picking up after the <ctl>p: 

»>H<cr> 

HALTED AT nnnnnnnn 

»>B<cr> 

CPU HALTED 

INIT SEQ DONE 

HALT INST EXECUTED 

HALTED AT nnnnnnnn 

LOAD DONE, nnnnnnnn BYTES LOADED 


The $$ prompt indicates that the stand-alone shell (sash) is ready to accept commands. If it is desired to 
run stand-alone/i'c^(lM) (or other stand-alone functions), this is the time to do it. The commands have the 
form /stand/program where program can be any name from a limited list of UNIX commands found in the 
directory /stand. To perform a file system consistency check, type: 

$$ /stand/fsck /dev/rpO 

To bring up UNIX, the operator must type unix<cr>. The system will come up through init 1 (see m/f(8)). 

This is the appropriate time to do file system backups, and/i'c/:(lM) should be executed if it was not exe¬ 
cuted in the stand-alone section of the boot. One must never operate the system with a defective file sys¬ 
tem. 

After successful completion of/?c/:(lM) and setting the date and time (see date(l)), the operator can bring 
the system to multi-user operation by executing init 2. 

Bringing the System Down 

The shutdown procedure is designed to gracefully turn off all processes and bring the system back to single 
user state with all buffers flushed. To do this the operator can execute shutdown(lM) or the following 
sequence of commands: 

killall 
sync 
init 1 

fsck (optional) 
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The system may then be halted by typing the <ctl>p and H<cr> sequence. 

System Dumps 

After a system crash, the following procedure should be used to get a system dump on tape. 

1. Mount a tape with write ring and bring it on-line. 

2. Enter console mode with <ctl>p. 

3. After the »> prompt, halt the system with H<cr>. 

4. Issue the following command sequence, each command followed by <cr>: 

E R0/N:F {Examine RO thru R15) 

E SP {Get the stack pointer for the next command) 

E/W @/N:3F {Examine virtual memory beginning at the address from the previous instruction, and 
continuing for the next 63 locations; i.e., examine the stack) 

ST 400 {Start execution at 400, i.e., dump to tape) 

5. Before returning to UNIX, execute the stand-alone/^^^(IM). 

System Faults 

On occasion, the UNIBUS or its devices fail in such a manner as to flood the console with error messages 
and suspend operations on UNIBUS devices. It may be possible under these conditions to bring the system 
down gracefully from an internal point-of-view, by inhibiting UNIBUS interrupts and running a normal 
shutdown. The following sequence can be executed: 

<ctl>p 

»>H 

»>E 20006004 {Look at VBA control register) 

»>D * 1 {Clear the VBA) 

»>C {Return to VRIX) 


You should now be able to login as root and run a normal shutdown sequence. Reboot the system by nor¬ 
mal means, ensuring/5cy^(lM) is performed. 

INSTALLATION BOOT PROCEDURES 
Tape Boot 

The floppy disk delivered with the VAX-11/780 does not have tape-boot capability. The user must type in 
the following program to read the first record on tape drive 0. Type <cr> at the end of each input line: 


INIT SEQ DONE 

>D 20000 20008FD0 
>D + D0502001 
>D -H 3204A001 
>D -H C003C08F 
>D -H A0D40424 
>D -H 8FD00C 
>D + C0800000 
>D -H 8F320800 
>D -H lOAOFEOO 
>D -H C007D0 
>D -H C039D004 
>D + 400 

> S 20000 (5- 


{Start tape load) 


HALT INST EXECUTED 
HALTED AT 0002002F 


{Execute boot program loaded from tape) 
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From this point the loader initiates a question and answer sequence to control the remainder of the load pro¬ 
cess. 


Disk Boot 

The floppy disk delivered with the VAX-11/780 does not have UNIX disk-boot capability. The user must 
type in the following program to read the first block on disk drive 0. Type <cr> at the end of each line. 

»>H 

»>LINK (Save the following sequence on the floppy) 

{The prompt should change to «<) 

«<H 

«<U 

«<I 

«<D 20000 00009FDE {Boot program for MBA 0, drive 0) 

«<D -H D0512001 
«<D -H D004A101 
«<D + 0400C113 
«<D + 10008F32 
«<D + D40424C1 
«<D -H 8FD00CA1 
«<D -H 80000000 
«<D -H 320800C1 
«<D -H A1FE008F 
«<D -H 28C1D410 
«<D -H 14C1D404 
«<D -H C139D004 
«<D + 00000400 
«< S 20000 
«<S 2 

«<<ctl>C {Exit LINK mode) 

You are now ready to boot UNIX. Each time it is necessary to boot (or reboot) UNIX, simply follow the 
sequence: 

»>P<cr> {Execute the commands saved in floppy link file; the console should echo each com¬ 
mand in the file.) 

$$ unix<cr> {Load and execute /unix) 

UNIX Floppy Update 

To update the console floppy for UNIX operation, one must have brought UNIX up by one of the initial-load 
procedures described above. The following sequence can then be executed. 

# cd /stand/conflp 

# sh update 

Update prints commentary during the update operation indicating the files that are being replaced or added. 
Finally, a new table of contents is printed and the available space is indicated. 

CONSOLE OPERATION 

The following is condensed from Chapter 2 of the VAX-l1/780 Hardware Handbook, DEC, 1978. 

The following are the standard console commands. The most abbreviated form is shown in parentheses. 

<ctl>P Causes console to exit Program I/O mode (talking to the VAX-11/780 program). This 

does not halt the VAX CPU. 


<ctl>U 

<del> 


Deletes the current input line. 
Deletes the previous character. 
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<ctI>C Interrupts printout. 

(HE)LP Prints ‘ ‘help’ ’ file of which this is a part. 

(E)XAMINE {address} 

Displays 8-digit hexadecimal address and its contents. See “help” file for qualifiers. 

(D)EPOSIT {address} {data} 

Enters data to address. 

(I)NITIALIZE Initializes CPU. 

(U)NJAM Unjams the SBI. 

(SH)OW Displays console and CPU state. 

(H)ALT Halts execution of VAX CPU instructions. 

(S)TART {address} 

Initializes CPU, enters address to PC, issues CONTINUE to CPU, and puts console into Pro¬ 
gram I/O mode. 

(C)ONTINUE Starts execution of VAX CPU instructions. 

(SE)T (T)ERMINAL (P)ROGRAM 

Puts console into Program I/O mode. 

@ {file} Causes the named floppy file to be printed and executed. 

WARNINGS 

Only <ctl>p can be executed from Program I/O mode. It does not stop the VAX CPU from running. Only 
HALT can be executed while the VAX CPU is running and not in Program I/O mode; therefore, the sequence 
to stop the VAX-11/780 while running UNIX (Program I/O mode) is: 

<ctl>p 

»>H<cr> 

FILES 

/etc/shutdown 

/stand/* 

SEE ALSO 

fsck(lM), shutdown(lM), fllesave(8), init(8), tapeboot(8). 



